DIV CSS 佈局教程網

jQuery 上傳外掛 Uploadify 詳解與錯誤排除
編輯:JQuery特效代碼     

Uploadify 是什麼

Uploadify 是 jQuery 的多檔上傳外掛,自帶進度條,效果相當完整。官網提供的是 PHP 版範例,本文記錄在 ASP.NET 下的完整使用方式。

準備工作

  1. 建立 Web 專案 JQueryUploadDemo,從官網下載最新版解壓後加入專案。
  2. 新增 UploadHandler.ashx 一般處理常式,負責接收上傳。
  3. 新增 UploadFile 資料夾,用來存放上傳的檔案。

Default.aspx

<link href="JS/jquery.uploadify-v2.1.0/example/css/default.css" rel="stylesheet" type="text/css" />
<link href="JS/jquery.uploadify-v2.1.0/uploadify.css" rel="stylesheet" type="text/css" />

<script type="text/javascript" src="JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="JS/jquery.uploadify-v2.1.0/swfobject.js"></script>
<script type="text/javascript"
  src="JS/jquery.uploadify-v2.1.0/jquery.uploadify.v2.1.0.min.js"></script>

<script type="text/javascript">
$(document).ready(function() {
  $("#uploadify").uploadify({
    'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf',
    'script': 'UploadHandler.ashx',
    'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png',
    'folder': 'UploadFile',
    'queueID': 'fileQueue',
    'auto': false,
    'multi': true
  });
});
</script>

<body>
<div id="fileQueue"></div>
<input type="file" name="uploadify" id="uploadify" />
<p>
<a href="javascript:$('#uploadify').uploadifyUpload()">上傳</a>|
<a href="javascript:$('#uploadify').uploadifyClearQueue()">取消上傳</a>
</p>
</body>

UploadHandler.ashx

public void ProcessRequest(HttpContext context)
{
    context.Response.ContentType = "text/plain";
    context.Response.Charset = "utf-8";

    HttpPostedFile file = context.Request.Files["Filedata"];
    string uploadPath =
        HttpContext.Current.Server.MapPath(context.Request["folder"]) + "\\";

    if (file != null)
    {
        if (!Directory.Exists(uploadPath))
        {
            Directory.CreateDirectory(uploadPath);
        }
        file.SaveAs(uploadPath + file.FileName);
        // 少了這行,上傳成功後佇列項目不會自動消失
        context.Response.Write("1");
    }
    else
    {
        context.Response.Write("0");
    }
}

這裡一定要 using System.IO;。我當初出錯就是漏了這個命名空間,而網上多數教學都沒特別提,導致不少人遇到 IOError。

執行後即可看到上傳介面:

選好兩個檔案按上傳,UploadFile 資料夾就會多出這兩個檔案。

參數:字串與布林值

uploadify 的參數是 JSON 物件,改 key 就能自訂行為,例如 multi 控制是否多檔上傳。

  • uploader:uploadify.swf 的相對路徑。這個 swf 就是那顆文字為 BROWSE 的按鈕,點擊後淡出並開啟檔案選擇框。預設 uploadify.swf。
  • script:後台處理常式的相對路徑。預設 uploadify.php。
  • checkScript:用來判斷所選檔案在伺服器上是否已存在的處理常式路徑。
  • fileDataName:伺服器端取檔的欄位名稱,預設 Filedata。
  • method:提交方式,Post 或 Get,預設 Post。
  • scriptAccess:flash 的存取模式,本機測試設為 always,預設 sameDomain。
  • folder:上傳檔案的存放目錄。
  • queueID:檔案佇列的 ID,需與承載佇列的 div 一致。
  • queueSizeLimit:多檔時可選擇的檔案數上限,預設 999。
  • multi:true 時可上傳多檔。
  • auto:true 時選檔後直接上傳,false 需按上傳鈕。
  • fileDesc:檔案選擇框的提示文字,需先設定 fileExt 才有效。設為「請選擇 rar doc pdf 文件」的實際效果如下圖。

  • fileExt:可選擇的檔案類型,格式如 '*.doc;*.pdf;*.rar'。
  • sizeLimit:上傳檔案的大小限制。
  • simUploadLimit:允許同時上傳的數量,預設 1。
  • buttonText:瀏覽鈕文字,預設 BROWSE。
  • buttonImg:瀏覽鈕圖片路徑。
  • hideButton:true 時隱藏瀏覽鈕圖片。
  • rollover:true 時滑鼠移到瀏覽鈕上有反轉效果。
  • width / height:瀏覽鈕寬高,預設 110 / 30。
  • wmode:設為 transparent 可讓 flash 背景透明並置於頁面最上層,預設 opaque。
  • cancelImg:檔案進入佇列後每個項目上的關閉鈕圖示。

參數:回呼函數

以下 key 的值是函數,可在選檔、出錯等時刻回傳資訊給使用者。

onInit

初始化工作。

onSelect

選擇檔案時觸發,三個參數:event(事件物件)、queueID(六碼隨機組成的唯一標識)、fileObj(檔案物件,含 name、size、creationDate、modificationDate、type 五個屬性)。

$(document).ready(function() {
  $("#uploadify").uploadify({
    'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf',
    'script': 'UploadHandler.ashx',
    'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png',
    'folder': 'UploadFile',
    'queueID': 'fileQueue',
    'auto': false,
    'multi': true,
    'onInit': function(){ alert("1"); },
    'onSelect': function(e, queueId, fileObj) {
      alert("唯一標識:" + queueId + "\r\n" +
            "文件名:" + fileObj.name + "\r\n" +
            "文件大小:" + fileObj.size + "\r\n" +
            "創建時間:" + fileObj.creationDate + "\r\n" +
            "最後修改時間:" + fileObj.modificationDate + "\r\n" +
            "文件類型:" + fileObj.type);
    }
  });
});

onSelectOnce

單檔或多檔上傳時,選檔觸發一次。參數 event 與 data,data 含:

  • fileCount:選取的檔案總數。
  • filesSelected:這次同時選取的數量,一次選 3 個則為 3。
  • filesReplaced:若佇列中已有 A、B,這次又選了 A、B,則為 2。
  • allBytesTotal:所有選取檔案的總大小。

onCancel

點擊佇列項目的關閉鈕或取消上傳時觸發。參數 event、queueId、fileObj、data;data 含 fileCount(取消後佇列剩餘數量)與 allBytesTotal(剩餘檔案大小)。

onClearQueue

呼叫 fileUploadClearQueue 時觸發,參數 event 與 data,含義同 onCancel 的對應參數。

onQueueFull

設定了 queueSizeLimit 且選擇數量超出時觸發,參數 event 與 queueSizeLimit。

onError

上傳出錯時觸發。參數 event、queueId、fileObj、errorObj。errorObj 有兩個屬性:type('HTTP'、'IO' 或 'Security')與 info(錯誤描述)。

onOpen / onProgress

點擊上傳時觸發(auto 為 true 則是選檔時),多檔時會遍歷整個佇列,onProgress 在 onOpen 之後。參數 event、queueId、fileObj、data;data 含 percentage(完成百分比)、bytesLoaded(當前上傳量)、allBytesLoaded(佇列中已完成的上傳量)、speed(速率 kb/s)。

onComplete

單檔上傳完成後觸發。參數 event、queueId、fileObj、response、data。response 是後台回傳值(範例中為 1 或 0),data 含 fileCount(尚未完成的數量)與 speed(平均速率)。此處的 fileObj 多了 filePath 屬性,可取出上傳後的路徑。

onAllComplete

整個佇列都完成後觸發。參數 event 與 data,data 含 filesUploaded(上傳檔案數)、errors(錯誤數)、allBytesLoaded(總大小)、speed(平均速率 kb/s)。

相關方法

  • uploadifySettings:動態修改上述設定。
    $('#uploadify').uploadifySettings('folder','JS');

若把上傳連結寫成下面這樣,檔案就會传到 uploadifySettings 指定的目錄:

<a href="javascript:$('#uploadify').uploadifySettings('folder','JS');$('#uploadify').uploadifyUpload()">上傳</a>
  • uploadifyCancel:接受一個 queueID,取消佇列中指定檔案。
    $('#uploadify').uploadifyCancel(id);

我遇到的兩個問題

1. Flash 沒載入。剛設定好時完全不能動,uploadify.swf 就是載不進來。查了 jquery.uploadify.v2.1.0.js 才知道它是用 swfobject.js 動態建立 Flash 的。另外寫了一個獨立測試頁也一樣顯示不出來,最後重開電腦就正常了——這類狀況多半與瀏覽器快取或 Flash 外掛狀態有關。

2. Flash 出來了,上傳卻失敗,報 IOError。

翻遍網路,最後在國外某個網站看到一句 using System.IO;,加上去立刻豁然開朗。

補充一點:Uploadify 2.x 依賴 Flash,而主流瀏覽器已全面停止支援 Flash,因此這套方案今天只能用於維護既有專案。新專案建議改用 HTML5 方案,例如 jQuery File Upload 或直接用 <input type="file" multiple> 搭配 FormData 與 $.ajax,就能取得多檔上傳與進度回報(XMLHttpRequest.upload.onprogress),不必再受 Flash 的限制。

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