上傳插件uploadify文檔粗略解讀

uploadify文檔粗略解讀

官方下載地址： http://www.uploadify.com/demos/

文檔閱讀：

通常性建議：

執行uploadify 使用uploadify方法 自定義服務器端上傳腳本 上傳時使用session

1.屬性

屬性有29個

auto

爲true時當選擇文件後就直接上傳了，爲false須要點擊上傳按鈕才上傳 。爲false時須要上傳按鈕

1. 布爾類型
2. 默認值true

##buttonClass

額外增長的上傳按鈕樣式類型

1. 字符串類型
2. 默認爲""

##buttonCursor

鼠標指針懸停在按鈕上的樣子

1. 字符串類型
2. 默認爲hand

##buttonImage

瀏覽按鈕的圖片的路徑 。

1. 字符串類型
2. 默認爲null

##buttonText

瀏覽按鈕的文本。

1. 字符串類型
2. 默認 SELECT FILES

##width

設置文件瀏覽按鈕的寬度。

1. 整形
2. 默認爲120

##height

設置瀏覽按鈕的高度

1. 整形
2. 默認值30

##swf

uploadify.swf 文件的相對路徑。

1. 字符串型
2. 默認‘uploadify.swf’ 同級目錄

##uploader

服務器端腳本處理路徑

1. 字符串型
2. 默認爲uploadify.php (官方默認的程序）

##uploadLimit

最大上傳文件數量，若是達到或超出此限制將會觸發onUploadError事件。

1. 整形
2. 默認999

##multi

是否能夠多文件上傳

1. 布爾型
2. 默認爲true

##method

提交方法

1. 字符串型
2. 默認 Post 提交方式Post或Get

##fileSizeLimit

上傳文件的大小限制 ，若是爲整數型則表示以KB爲單位的大小，若是是字符串，則能夠使用(B, KB, MB, or GB)爲單位，好比’2MB’；若是設置爲0則表示無限制

1. 默認爲0

##fileObjName

文件上傳對象的名稱，若是命名爲’the_files’，PHP程序能夠用$_FILES['the_files']來處理上傳的文件對象。

1. 字符串型
2. 默認‘Filedata’

##debug

默認false 若是設置爲true則表示啓用SWFUpload的調試模式

##formData

JSON格式上傳每一個文件的同時提交到服務器的額外數據，可在’onUploadStart’事件中使用’settings’方法動態設置。

##fileTypeExts

指定容許上傳的文件類型。

1. 默認*.*。
2. 好比只支持gif , jpg , png類型的圖像，那麼該屬性設置爲: ‘.gif; .jpg ; .png’,支持文件格式如：’.doc;.pdf;.rar’ 。

##fileTypeDesc

限制文件類型顯示

1. 默認‘All Files’
2. 這個屬性值必須設置fileTypeExts屬性後纔有效，用來設置選擇文件對話框中的提示文本，如設置fileTypeDesc爲「請選擇rar doc pdf文件」

##preventCaching

每次上傳文件時自動加上一串隨機字符串參數，防止URL緩存影響上傳結果

1. 布爾型
2. 默認爲true

##progressData

設置上傳進度顯示方式，percentage顯示上傳百分比，speed顯示上傳速度

1. 字符串型
2. 默認‘percentage’

##removeCompleted

表示在上傳完成後是否刪除隊列中的對應元素。默認是True，即上傳完成後 就看不到上傳文件進度條了。

removeTimeout

表示上傳完成後多久刪除隊列中的進度條，默認爲3，即3秒。

##successTimeout

表示文件上傳完成後等待服務器響應的時間。超過該時間，那麼將認爲上傳 成功。默認是30，表示30秒。

#2.事件 ##onSelect 選擇

onSelect(file)選擇文件後向隊列中添加每一個上傳任務時都會觸發。file爲文件對象

##onCancel 取消

onCancel(file)當點擊文件隊列中文件的關閉按鈕或點擊取消上傳時觸發，file參數爲被取消上傳的文件對象

##onUploadComplete 上傳完成

onUploadComplete(file)每一個文件上傳完畢後不管成功與否都會觸發。

##onUploadError 文件上傳出錯

onUploadError(file, errorCode, errorMsg, errorString)文件上傳出錯時觸發，參數由服務端程序返回。

1. file The file object that was uploaded
2. errorCode The error code that was returned
3. errorMsg The error message that was returned
4. errorString The human-readable error message containing all the details of the error

##onUploadSuccess 文件上傳成功

onUploadSuccess(file, data, response) 當文件上傳成功時觸發

1. file – 文件對象
2. data – 服務端輸出返回的信息
3. response – 有輸出時爲true,若是無響應爲false，若是返回的是false,當超過successTimeout設置的時間後假定爲true

#3.方法

##cancel

取消隊列中的任務，無論此任務是否已經開始上傳

<a href="javascript:$(‘#file_upload’).uploadify(‘cancel’)">取消第一個</a>

##destroy

銷燬Uploadify實例並將文件上傳按鈕恢復到原始狀態

##disable

禁用或啓用文件瀏覽按鈕

##settings

獲取或設置Uploadify實例參數

##stop

中止當前正在上傳的任務

##upload

當即上傳指定的文件，若是fileID爲’*'表示上傳全部文件，要指定上傳多個文件，則將每一個文件的fileID做爲一個參數

king