ajaxFileUpload.js 是個很方便的 jQuery 上傳外掛,但原廠版本只支援單一檔案。本文示範如何改寫它的原始碼,讓 fileElementId 可以傳入陣列,一次批次上傳多個檔案。
原始碼中原本針對單一 fileElementId 做節點複製的邏輯如下(已註解):
// 修改前
// var oldElement = jQuery('#' + fileElementId);
// var newElement = jQuery(oldElement).clone();
// jQuery(oldElement).attr('id', fileId);
// jQuery(oldElement).before(newElement);
// jQuery(oldElement).appendTo(form);
改成 traverse 傳入的陣列即可:
// 修改後
for(var i in fileElementId){
var oldElement = jQuery('#' + fileElementId[i]);
var newElement = jQuery(oldElement).clone();
jQuery(oldElement).attr('id', fileId);
jQuery(oldElement).before(newElement);
jQuery(oldElement).appendTo(form);
}
這裡的關鍵是:外掛會把原本的 file input 複製一份、改 id 後再放回表單,藉此讓同一個 input 能重複被選檔。改成迴圈後,每個 id 都各自擁有一份副本,多檔並傳才不會互相干擾。
$.ajaxFileUpload({
url : "./upload/upload.action",
secureuri : false,
// fileElementId : 'uploadfile1', // 原本的用法
fileElementId : ['uploadfile1','uploadfile2','uploadfile3','uploadfile4','uploadfile5'],
dataType : 'json',
success : function(data) {
ajaxLoadEnd();
if (data.result == "success") {
$.messager.alert('信息','導入成功。','info');
} else {
$('#import_right').dialog('open');
$.messager.alert('信息','導入失敗。<br>錯誤信息:' + data.message,'error');
}
},
error : function(data, status, e) {
ajaxLoadEnd();
$.messager.alert('信息','導入失敗。<br>錯誤信息:網絡異常或表單數據錯誤。','error');
}
});
1. 使用 for...in 走訪陣列並不理想。它會把原型鏈上的可列舉屬性一起走訪,建議改成傳統的 for (var i = 0; i < fileElementId.length; i++)。
2. 成功與失敗的判斷要更嚴謹。範例只看 data.result,實務上應同時檢查上傳了幾個檔案、哪些失敗,並逐一回饋給使用者。
3. 後端要逐檔處理。批次上傳時伺服器收到的仍是多個獨立的請求,每個檔案都要各自做格式、大小與內容的檢核。
4. 可考慮改用 HTML5 方案。若專案不需相容 IE8 以下,用 FormData 搭配 $.ajax 就能 natively 支援多檔上傳,不必修改任何外掛原始碼。