批量上傳的本質,就是把多個上傳任務放進一個佇列裡,然後逐一處理。自己從零實作需要處理分片、非同步、進度回報等一堆細節,而 plupload 這套由 TinyMCE 團隊開發的插件,把這些都封裝好了,同時保留了足夠的自訂空間——包括在每次上傳時動態帶入不同的參數。

需求是這樣的:使用者先從下拉選單挑選「附件類型」,再選檔案,然後一次批次上傳。每個檔案要帶上自己對應的類型,因此必須在 BeforeUpload 這個時機點,為每個檔案分別設定 multipart_params。做法是先用一個 map 物件把「檔案 id → 檔案類型」記下來。
<script type="text/javascript">
var map = {}; // key 為檔案 id,value 為檔案類型
var uploader = new plupload.Uploader({
runtimes : 'html5,flash,silverlight,html4',
browse_button : 'pickfiles',
container : document.getElementById('container'),
url : '../action/photoUpload.jsp',
flash_swf_url : '../../js/Moxie.swf',
silverlight_xap_url : '../../js/Moxie.xap',
filters : {
max_file_size : '5mb',
mime_types : [ { title : "圖片類型", extensions : "jpg,gif,png" } ]
},
init : {
PostInit : function () {
document.getElementById('uploadfiles').onclick = function () {
uploader.start();
return false;
};
},
// 重點:上傳前為該檔案設定自訂參數
BeforeUpload : function (up, file) {
uploader.setOption("multipart_params", {
"apptype": ${param.type},
"id": ${param.id},
"fileType": map[file.id]
});
},
FileUploaded : function (up, file) {
$("#" + file.id + "btn").parent().html("上傳完畢");
$("#" + file.id + "btn").remove();
},
FilesAdded : function (up, files) {
if ($("#fileType").val() == 1) {
alert("請先選擇附件類型!");
plupload.each(files, function (file) {
uploader.removeFile(file.id);
});
return false;
}
plupload.each(files, function (file) {
map[file.id] = $("#fileType").val();
$("#uploadTable").append(
"<tr id='" + file.id + "tr'>" +
"<td>" + $("#fileType").val() + "</td>" +
"<td>" + file.name + "</td>" +
"<td><button type='button' id='" + file.id + "btn' " +
"onclick=del('" + file.id + "')>刪除</button></td>" +
"<td id='" + file.id + "_progress'></td></tr>"
);
});
},
UploadProgress : function (up, file) {
$("#" + file.id + "_progress").html('<span>' + file.percent + "%</span>");
},
Error : function (up, err) {
alert("此檔案上傳失敗!");
}
}
});
uploader.init();
// 依檔案 id 移除檔案並同步清掉表格中的那一列
function del(id) {
uploader.removeFile(id);
$("#" + id + "tr").remove();
map[id] = "";
}
</script>
腳本要能跑起來,頁面至少要備妥 these 幾個容器:
<div id="filelist"></div>
<div id="container">
<center>
提示:必須上傳「商戶營業執照」、「稅務登記證明」、「企業法人身份證」、
「考察照片」、「商戶信息調查表」、「商戶協議」才能提交審批!
</center>
<label>附件類型:</label>
<select name="fileType" id="fileType">
<option value="1">-------請選擇-----</option>
<option value="商戶營業執照">商戶營業執照</option>
<option value="稅務登記證明">稅務登記證明</option>
<option value="商戶信息變更表">商戶信息變更表</option>
<option value="其他">其他</option>
</select>
<button class="button" id="pickfiles">選擇文件</button>
<button class="button" id="uploadfiles">批量上傳</button>
<button class="button" onclick="window.location.reload()">刷新</button>
<button class="button" onclick="window.close()">關閉視窗</button>
<table style="width: 600px" id="uploadTable" border="1">
<tr>
<td>文件類型</td>
<td>文件名稱</td>
<td>操作</td>
<td>上傳進度</td>
</tr>
</table>
</div>
更多可設定的參數與事件,建議直接查閱官方文件(plupload.com)。實作時務必記得:前端的所有驗證都只是使用者體驗層面的保護,真正的檔案類型與大小檢查一定要在伺服器端再做一次,因為任何前端限制都可以被繞過。