幫助文檔

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

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

部署

在部署一個Uploadify實例之前，必須確保滿足最小需求：

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

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

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

在你的網站根目錄新建一個頁面，然后將以下代碼粘帖到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(函數() {

$('#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"?/>

當頁面被載入時，file域將被Uploadify文件上傳組件自動替換。

注意事項

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

如果你想要對Uploadify進行更多的定制，可以使用下面的可選項。

可選項

(布爾型)

auto

當文件被添加到隊列時，自動上傳。

(字符串)

buttonImg

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

(字符串)

buttonText

默認在按鈕上顯示的文本。

(字符串)

cancelImg

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

(字符串)

checkScript

用以檢查服務器上已存在文件的后臺腳本的路徑。【譯者注：應該是ajax方式】

(字符串)

displayData

在上傳過程中顯示在隊列里的數據類型。

(字符串)

expressInstall

expressInstall.swf文件的路徑。

(字符串)

fileDataName

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

(字符串)

fileDesc

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

(字符串)

fileExt

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

(字符串)

folder

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

(整型)

height

瀏覽按鈕的高度。

(布爾型)

hideButton

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

(字符串)

method

向后臺腳本放送數據的表單方法。

(布爾型)

multi

設置為true將允許多文件上傳。

(字符串)

queueID

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

(整型)

queueSizeLimit

上傳隊列中所允許的文件數量。

(布爾型)

removeCompleted

設置為true將自動移除隊列中已經完成上傳的項目。

(布爾型)

rollover

設置為true將激活瀏覽按鈕的鼠標劃過狀態。

(字符串)

script

處理文件上傳的后臺腳本的路徑。

(字符串)

scriptAccess

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

(JSON object with mixed types)

scriptData

在文件上傳時，應該被發送給后臺腳本的一個包含name/value鍵值對以及一些額外信息的json對象。

(整型)

simUploadLimit

允許同時上傳的文件數量。

(整型)

sizeLimit

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

(字符串)

uploader

uploadify.swf文件的路徑。

(整型)

width

瀏覽按鈕的寬度。

(字符串)

wmode

flash文件的wmode。

事件

(函數)

onAllComplete

當上傳隊列中的所有文件都完成上傳時觸發。

(函數)

onCancel

當從上傳隊列每移除一個文件時觸發一次。

(函數)

onCheck

在上傳開始之前，如果檢測到一個同名文件時觸發。

(函數)

onClearQueue

當uploadifyClearQueue()方法被調用時觸發。

(函數)

onComplete

每完成一次文件上傳時觸發一次。

(函數)

onError

當上傳返回錯誤時觸發。

(函數)

onInit

當Uploadify實例被載入時觸發。

(函數)

onOpen

當上傳隊列中的一個文件開始上傳時就觸發一次。

(函數)

onProgress

在上傳過程中觸發。

(函數)

onQueueFull

當文件數量達到上傳隊列限制時觸發。

(函數)

onSelect

每向上傳隊列添加一個文件時觸發。

(函數)

onSelectOnce

每向上傳隊列添加一個或一組文件時觸發。

(函數)

onSWFReady

當flash文件載入完成時觸發。

方法

?

.uploadify()

創建Uploadify上傳組件的一個實例。

?

.uploadifyCancel()

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

?

.uploadifyClearQueue()

將所有文件移除出上傳隊列，并且取消正在執行的所有上傳。

?

.uploadifySettings()

改變Uploadify組件的可選參數。

?

.uploadifyUpload()

觸發上傳。

?

?

轉發：http://www.phptogether.com/uploadifydoc/

總結

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

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。