uploadify的doc(選項,事件,方法)(翻譯自官網)

選項:

anto(boolean):

默認值:true 

在選擇文件後是否自動上傳,如果設置爲false,上傳要用方法觸發。


buttonClass(String):

默認值:空文本   是否必需:是

添加到上傳按鈕的class。


buttonCursor(String):

默認值:‘hand’ 

光標停留在按鈕上呈現的是手形'hand'或箭頭'arrow'。


buttonImage(String):

默認值 :null  

作爲背景的圖像路徑(如果需要背景圖,最好是在CSS中設置背景圖片)。


buttonText(String):

默認值:'SELECT FILES' 

顯示在按鈕上的文字。


checkExisting(String):

默認值:false  

路徑,檢驗在此文件夾中是否已存在當前上傳文件的文件名,是返回1,否返回0。


debug(Boolean):

默認值:false 

是否打印調試信息,設置爲true會在頁面打印出uploadify的調試信息。


fileObjName(String):

默認值:'FileData' 

在服務器端使用的文件對象名。


fileSizeLimit(Number):

默認值:無  

允許上傳的最大文件,這個值可以是Number或者String類型的,如果是String類型的,它接收的單位是B,KB,MB或者GB(默認是KB),設置爲0表示沒限制。


fileTypeDesc(String):

默認值:'All Files'  

可選類型,給定一個值,會在選擇上傳文件的對話框的下方的”文件類型:“這個下拉框中顯示以供選擇(比較費解,我截了張圖)。

如設置fileTypeDesc: 'Image File'這樣:



fileTypeExts(String):

默認值:'*.*'   

允許上傳文件的擴展名,一些類型會繞過這個安全等級(未被檢驗出),所以應該在服務器端再檢驗;多個擴展名應該用分號隔開:(i.e. ‘*.jpg; *.png; *.gif’)。


formDate(JSON對象):

默認值:空對象  

包含附加數據的對象,在每一次文件上傳時,會通過get或post發送。如果想動態地設置這些值,那麼應該使用onUploadStart事件中的'settings'方法,你可以在服務器端使用$_GET或者$_POST數組接收這些值(PHP)。(抱歉,PHP我不懂,暫且這樣翻譯)


height(Number):

默認值:30  

按鈕的高度(像素)。


itemTeplate(String):

默認值:false

可給每一個添加到隊列中的選項指定一個特定的HTML模板。

可選模板標籤:

instanceID:Uploadify實例的ID;

fileID:添加到隊列中文件的ID;

fileName:添加到隊列中文件的名稱。

fileSize:添加到隊列中的文件的大小。

模板的標籤插入到模板中:${fileName}


method(String):

默認值:'post'  

文件上傳時使用的方法。可選用'post'或'get'。


multi(Boolean):

默認值:true 

是否可一次上傳多個文件,設置成false一次只能選擇一個文件上傳。


overrideEvents(JSON數組):

默認值:空數組   

定義了一組不想在默認腳本中執行的事件名稱。


preventCaching(BNoolean):

默認值:true

如果設置爲true,會在SWF文件的URL添加一個隨機值,因此不會緩存。


progressData(String):

默認值:'percentage'

文件上傳進度呈現的方式。可選'percentage'或'speed'。


queueID(String):

默認值:flase

作爲文件隊列使用的DOM元素的ID。文件隊列會直接添加這些已經定義的元素。如果設置爲false,會生成一個文件隊列,queueID也可以動態地設置。


queuerSizeLimit(Number):

默認值:999

隊列中一次能存放的文件數,這個不限制文件的上傳數(如果想限制文件的上傳數,可使用uploadLimit);如果添加到隊列的文件數超過這個限制,onSelectError事件會被觸發。


removeCompleted(Boolean):

默認值:true

設置爲false會在隊列中保存已經完成上傳的文件。


removeTimeout(Number):

默認值:3

從隊列中移除已上傳文件的延遲秒數。


requeueErrors(Boolean):

默認值:false

設置爲true時,上傳隊列重置或上傳多次重試後返回錯誤信息。


successTimeout(Number):

默認值:30

一個文件完成上傳時等待服務器響應的時間(秒)。


swf(String):

默認值:'uploadify.swf'  是否必需:是

uploadify.swf文件的路徑。


uploader(String):

默認值:'uploadify.php'   是否必需:是

服務器端上傳腳本的路徑。


uploadLimit(Number):

默認值:999 

可上傳的文件數,超過這個數量,onUploadError事件會被觸發。


width(Number):

默認值:120

按鈕的寬度(像素)。設置值的時候請不要包含'px',這個值只能是整型的。


事件:

onCancel(function):

文件從隊列中移除時觸發。


onClearQueue(function):

cancel方法被以'*'作爲參數激活時觸發。


onDestroy(function):

使用destroy方法時觸發。


onDialogClose(function):

重寫:不適用

瀏覽文件的對話框關閉後觸發。如果這個事件添加到overrideEvents選項中,添加文件到隊列時發生錯誤,不會彈出默認的錯誤信息。


onDialogOpen(function):

在瀏覽文件對話框打開前一瞬觸發。


onDisable(function):

使用disable方法後,Uploadify的實例不可用時觸發。


onEnable(function):

使用enable方法後,Uploadify按鈕可用時觸發。


onFallback(function):

瀏覽器檢測不到Flash的兼容版本時觸發。


onInit(function):

Uploadify第一次調用,初始化接觸時觸發。


onQueueComplete(function):

在隊列中的全部文件被處理完後觸發。


onSelect(function):

重寫:不適用

選中文件添加到隊列中時被觸發。


onSelectError(function):

重寫:不適用

選擇文件返回錯誤被觸發。


onSWFReady(function):

Flash對象加載完畢後觸發。


onUploadComplete(function):

重寫:不適用

文件上傳完成後(無論成功與否)馬上觸發。如果想知道是否成功上傳,可以使用onUploadSuccess事件或onUploadError事件。


onUploadError(function):

文件上傳後返回錯誤信息時被觸發。


onUploadProgress(function):

重寫:不適用

上傳進度更新時觸發。


onUploadStart(function):

在開始上傳前瞬間觸發。


onUploadSuccess(function):

重寫:不適用

文件成功上傳後觸發。


方法:

cancel:

方法調用:'cancel'

取消要上傳的文件。


destroy:

方法調用:'destroy'

銷燬Uploadify實例並返回原文件域。


disable:

方法調用:'disable'

使按鈕是否可用。


settings:

方法調用:'settings'

返回或更新Uploadify實例的值。


stop:

停止當前上傳。


upload:

上傳指定的文件或是隊列中的全部文件。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章