使用 ajaxFileUpload.js 插件,並將其改寫為支援多檔案上傳。
原插件只支援單一檔案,需要改動處理 fileElementId 的那一段。
// 修改前
// var oldElement = jQuery('#' + fileElementId);
// var newElement = jQuery(oldElement).clone();
// jQuery(oldElement).attr('id', fileId);
// jQuery(oldElement).before(newElement);
// jQuery(oldElement).appendTo(form);
// 修改後:改為遍歷所有 fileElementId
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 可以重複被選擇。
$.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');
}
});
這種「用偽 iframe 模擬非同步上傳」的手法,是 XMLHttpRequest 尚無法傳送檔案時期的產物。ajaxFileUpload 的原理是把表單 target 指向一個隱藏的 iframe,藉此避開整頁刷新。
今日已無此必要。FormData 搭配 fetch 或 $.ajax 就能原生處理多檔上傳,並可回報進度:
var fd = new FormData();
fd.append('files', document.getElementById('f1').files[0]);
fd.append('files', document.getElementById('f2').files[0]);
fetch('/upload', { method: 'POST', body: fd })
.then(function (r) { return r.json(); })
.then(function (data) { console.log(data); });
若使用 jQuery,別忘了加上 processData: false 與 contentType: false,否則 jQuery 會嘗試把 FormData 序列化而導致失敗——這是遷移時最常踩到的坑。
另外,改造後的程式碼用 for...in 遍歷陣列並不可靠(它會走訪所有可枚舉屬性,且順序不保證),應改用一般 for 迴圈或 forEach。上傳環節也務必在伺服器端驗證檔案型別與大小,前端限制只能改善體驗,不能作為安全措施。