選項:
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:
上傳指定的文件或是隊列中的全部文件。