幫助文檔

Uploadify是一個(gè)易集成的多文件上傳解決方案，在手冊翻譯時(shí)，最新的穩(wěn)定版本是2.1.4，3.0版目前還在測試中。作為一個(gè)jQuery插件，Uploadify不僅使用簡單而且可定制性非常強(qiáng)。

盡管成功部署Uploadify可能需要掌握一定的jQuery知識(shí)，但是此幫助文檔所提供的參考，應(yīng)該足以幫助那些在使用Uploadify過程中遇到困難的人。如果你遇到了此文檔無法為你解決的問題，可以訪問Uploadify用戶社區(qū)來尋求幫助。 另外，我們還提供了一系列的常見問題?，也有助于你順利使用Uploadify。

部署

在部署一個(gè)Uploadify實(shí)例之前，必須確保滿足最小需求：

• jQuery 1.4.x or greater
• swfObject 2.2 or greater
• Flash Player 9.0.24 or greater

下載最新的zip壓縮包。將以下文件解壓縮到你網(wǎng)站根目錄的"uploadify"文件夾中。

• cancel.png
• jquery.uploadify.v2.1.4.min.js
• jquery-1.4.2.min.js
• swfobject.js
• uploadify.css
• uploadify.php
• uploadify.swf

在你的網(wǎng)站根目錄新建一個(gè)頁面，然后將以下代碼粘帖到HTML文檔的HEAD部分：

Head Section

<link?href="/uploadify/uploadify.css"?type="text/css"?rel="stylesheet"?/>

<script?type="text/javascript"?src="/uploadify/jquery-1.4.2.min.js"></script>

<script?type="text/javascript"?src="/uploadify/swfobject.js"></script>

<script?type="text/javascript"?src="/uploadify/jquery.uploadify.v2.1.4.min.js"></script>

<script?type="text/javascript">

$(document).ready(函數(shù)() {

$('#file_upload').uploadify({

'uploader' ?: '/uploadify/uploadify.swf',

'script' ? ?: '/uploadify/uploadify.php',

'cancelImg' : '/uploadify/cancel.png',

'folder' ? ?: '/uploads',

'auto' ? ? ?: true

});

});

</script>

*確保上傳文件夾存在并且是可寫的。

在頁面的body部分，添加如下代碼：

Body Section

<input?id="file_upload"?name="file_upload"?type="file"?/>

當(dāng)頁面被載入時(shí)，file域?qū)⒈籙ploadify文件上傳組件自動(dòng)替換。

注意事項(xiàng)

• 我們強(qiáng)烈建議使用相對于網(wǎng)站根目錄的路徑(也就是以一個(gè)正斜杠'/'開始)。否則，Uploadify將使用相對于當(dāng)前頁面的路徑。
• 應(yīng)用于Uploadify的每個(gè)元素必須擁有一個(gè)唯一的ID屬性。你可以參考引用class的元素，但是每個(gè)元素必須擁有一個(gè)唯一的ID。

如果你想要對Uploadify進(jìn)行更多的定制，可以使用下面的可選項(xiàng)。

可選項(xiàng)

(布爾型)

auto

當(dāng)文件被添加到隊(duì)列時(shí)，自動(dòng)上傳。

(字符串)

buttonImg

瀏覽按鈕的背景圖片路徑。

(字符串)

buttonText

默認(rèn)在按鈕上顯示的文本。

(字符串)

cancelImg

取消按鈕的背景圖片路徑。

(字符串)

checkScript

用以檢查服務(wù)器上已存在文件的后臺(tái)腳本的路徑。【譯者注：應(yīng)該是ajax方式】

(字符串)

displayData

在上傳過程中顯示在隊(duì)列里的數(shù)據(jù)類型。

(字符串)

expressInstall

expressInstall.swf文件的路徑。

(字符串)

fileDataName

后臺(tái)腳本中要處理的file域的名稱。【譯者注：就是type為file的input的name值】

(字符串)

fileDesc

在瀏覽窗口底部的文件類型下拉菜單中顯示的文本。

(字符串)

fileExt

允許上傳的文件后綴。【譯者注：.jpg/.png等】

(字符串)

folder

上傳文件夾的路徑，文件上傳后將被保存于此。

(整型)

height

瀏覽按鈕的高度。

(布爾型)

hideButton

設(shè)置為true將隱藏flash按鈕，這樣你就可以為下面的div元素定義樣式。

(字符串)

method

向后臺(tái)腳本放送數(shù)據(jù)的表單方法。

(布爾型)

multi

設(shè)置為true將允許多文件上傳。

(字符串)

queueID

頁面中，你想要用來作為文件隊(duì)列的元素的id。

(整型)

queueSizeLimit

上傳隊(duì)列中所允許的文件數(shù)量。

(布爾型)

removeCompleted

設(shè)置為true將自動(dòng)移除隊(duì)列中已經(jīng)完成上傳的項(xiàng)目。

(布爾型)

rollover

設(shè)置為true將激活瀏覽按鈕的鼠標(biāo)劃過狀態(tài)。

(字符串)

script

處理文件上傳的后臺(tái)腳本的路徑。

(字符串)

scriptAccess

設(shè)置在主swf文件中的腳本訪問模式。

(JSON object with mixed types)

scriptData

在文件上傳時(shí)，應(yīng)該被發(fā)送給后臺(tái)腳本的一個(gè)包含name/value鍵值對以及一些額外信息的json對象。

(整型)

simUploadLimit

允許同時(shí)上傳的文件數(shù)量。

(整型)

sizeLimit

上傳文件的大小限制，單位為字節(jié)。

(字符串)

uploader

uploadify.swf文件的路徑。

(整型)

width

瀏覽按鈕的寬度。

(字符串)

wmode

flash文件的wmode。

事件

(函數(shù))

onAllComplete

當(dāng)上傳隊(duì)列中的所有文件都完成上傳時(shí)觸發(fā)。

(函數(shù))

onCancel

當(dāng)從上傳隊(duì)列每移除一個(gè)文件時(shí)觸發(fā)一次。

(函數(shù))

onCheck

在上傳開始之前，如果檢測到一個(gè)同名文件時(shí)觸發(fā)。

(函數(shù))

onClearQueue

當(dāng)uploadifyClearQueue()方法被調(diào)用時(shí)觸發(fā)。

(函數(shù))

onComplete

每完成一次文件上傳時(shí)觸發(fā)一次。

(函數(shù))

onError

當(dāng)上傳返回錯(cuò)誤時(shí)觸發(fā)。

(函數(shù))

onInit

當(dāng)Uploadify實(shí)例被載入時(shí)觸發(fā)。

(函數(shù))

onOpen

當(dāng)上傳隊(duì)列中的一個(gè)文件開始上傳時(shí)就觸發(fā)一次。

(函數(shù))

onProgress

在上傳過程中觸發(fā)。

(函數(shù))

onQueueFull

當(dāng)文件數(shù)量達(dá)到上傳隊(duì)列限制時(shí)觸發(fā)。

(函數(shù))

onSelect

每向上傳隊(duì)列添加一個(gè)文件時(shí)觸發(fā)。

(函數(shù))

onSelectOnce

每向上傳隊(duì)列添加一個(gè)或一組文件時(shí)觸發(fā)。

(函數(shù))

onSWFReady

當(dāng)flash文件載入完成時(shí)觸發(fā)。

方法

?

.uploadify()

創(chuàng)建Uploadify上傳組件的一個(gè)實(shí)例。

?

.uploadifyCancel()

從上傳隊(duì)列移除一個(gè)文件。如果文件正在上傳，該方法將先取消上傳，然后再將文件移除出上傳隊(duì)列。

?

.uploadifyClearQueue()

將所有文件移除出上傳隊(duì)列，并且取消正在執(zhí)行的所有上傳。

?

.uploadifySettings()

改變Uploadify組件的可選參數(shù)。

?

.uploadifyUpload()

觸發(fā)上傳。

?

?

轉(zhuǎn)發(fā)：http://www.phptogether.com/uploadifydoc/

總結(jié)

以上是生活随笔為你收集整理的Uploadify-中文帮助手册的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。