DIV CSS 佈局教程網

jQuery 檔案上傳外掛 Uploadify 使用指南
編輯:JQuery特效代碼     

Uploadify 是一款功能強大的檔案上傳外掛。相較於 Flash 版本,它的 HTML5 版本對行動瀏覽器的支援更好,能避開部分手機 Safari 不支援 Flash 的問題。主要特色包括:多檔案上傳、HTML5 版可拖曳上傳、即時進度條顯示,以及對檔案大小、類型、按鈕圖示、後端處理腳本等的強大參數自訂能力。

Flash 版本使用步驟

第一步,載入 jQuery、Uploadify 的 JS 與 CSS:

第二步,撰寫 HTML,放上一個多選的 file 輸入框與一個用來承載檔案佇列的容器:

第三步,在文件就緒時呼叫 uploadify,設定 uploader(swf 路徑)、script(後端處理程式)、folder(存放目錄)、queueID(佇列容器 id)、auto(是否選檔後直接上傳)、multi(是否多檔)等參數。

常用參數說明

uploader:uploadify.swf 的相對路徑,即那個帶有 BROWSE 文字、點擊後會開啟檔案對話框的 Flash 按鈕。

script:後端處理程式的相對路徑,預設 uploadify.php。

fileDataName:伺服器端取得上傳資料時所用的欄位名,預設 Filedata。

folder:檔案存放目錄。queueID:檔案佇列容器 id。

multi:設為 true 可上傳多檔。auto:設為 true 時選檔後直接上傳,false 則需點擊上傳鈕。

fileDesc / fileExt:搭配使用,前者設定檔案對話框的提示文字,後者限定可選的檔案類型(如 '*.doc;*.pdf;*.rar')。

sizeLimit:單檔大小限制。simUploadLimit:同時上傳的檔案數,預設 1。

buttonText / buttonImg / hideButton / rollover / width / height / wmode:分別控制瀏覽按鈕的文字、圖示、隱藏、滑入反轉效果、寬高與 Flash 背景透明度。

cancelImg:檔案進入佇列後每個項目上的關閉圖示。

事件回呼參數

除了上述字串與布林型參數,Uploadify 還有一批值為函式的事件回呼,可在選檔、出錯等操作時回傳資訊給使用者:

onInit:初始化工作。

onSelect:選擇單一檔案時觸發,帶有 event、queueID(六碼隨機唯一識別)、fileObj(含 name、size、creationDate、modificationDate、type 五個屬性的檔案物件)。

onSelectOnce:單/多檔選擇時觸發,data 物件含 fileCount、filesSelected、filesReplaced、allBytesTotal 等屬性。

onCancel:關閉佇列檔案或取消上傳時觸發。

onClearQueue:呼叫 fileUploadClearQueue 時觸發。

onQueueFull:選擇檔案數超出 queueSizeLimit 時觸發。

onError:上傳出錯時觸發,errorObj 含 type(HTTP、IO 或 Security)與 info(錯誤描述)。

onOpen / onProgress:點擊或選檔上傳時觸發,onProgress 的 data 含 percentage、bytesLoaded、allBytesLoaded、speed 等即時進度資訊。

onComplete:單檔上傳完成後觸發,response 為後端回傳值,data 含剩餘檔案數與平均速率。

onAllComplete:整個佇列上傳完成後觸發,data 含 filesUploaded、errors、allBytesLoaded、speed 等統計資訊。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved