ajaxfileupload 是 jQuery 時代常見的無外掛檔案上傳方案,原理是建立隱藏 iframe,讓表單以一般 submit 送出後,再把 iframe 中的回應取出來,藉此模擬 AJAX。但它預設只送檔案,不支援附加參數。以下是擴充方式。
$.ajaxFileUpload({
url: 'upload.php',
data: { "a": 123, "b": 456 }, // 附加參數,JSON 格式
success: function (response) {
console.log(response);
}
});
第一處:讓 createUploadForm 接收 data 參數(約在第 26 行附近)
createUploadForm: function (id, fileElementId, data) {
// ...原有程式碼...
}
在函式主體中,把 data 中的每個鍵值對轉成隱藏欄位附加到表單:
if (data) {
for (var i in data) {
$('<input type="hidden" name="' + i + '" value="' + data[i] + '" />')
.appendTo(form);
}
}
第二處:把 data 傳進 createUploadForm 的呼叫點
ajaxFileUpload: function (s) {
// ...
var form = jQuery.createUploadForm(id, s.fileElementId, s.data);
// ...
}
改完這兩處,附加參數就會以隱藏欄位的形式隨表單一起送出,後端用一般表單參數接收即可。
data 的值含引號或 <、>,會破壞 HTML 結構甚至造成 XSS。建議改用 DOM API:
if (data) {
for (var key in data) {
if (!Object.prototype.hasOwnProperty.call(data, key)) continue;
var input = document.createElement('input');
input.type = 'hidden';
input.name = key;
input.value = data[key];
form.appendChild(input);
}
}
[object Object],需要自行 JSON 序列化後以單一欄位傳送。這個外掛的 iframe 手法已是歷史產物。今天的專案請直接用標準 API:
var formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('a', 123); // 附加參數直接 append
formData.append('b', 456);
// 注意:不要手動設定 Content-Type,瀏覽器會自動加上 boundary
fetch('/upload', {
method: 'POST',
body: formData
})
.then(function (res) { return res.json(); })
.then(function (data) { console.log(data); });
或用 jQuery 的 $.ajax(jQuery 1.5+ 已原生支援檔案上傳):
$.ajax({
url: '/upload',
type: 'POST',
data: formData,
processData: false, // 不處理 data
contentType: false, // 不設定 Content-Type
success: function (res) { console.log(res); }
});
FormData 的優勢明顯:附加參數用 append 即可、支援多檔案、可用 XMLHttpRequest.upload.onprogress 顯示進度、不必改造任何外掛原始碼。
總結:改造 ajaxfileupload 的關鍵就是「在 createUploadForm 中把 data 轉為隱藏欄位,並把參數傳進去」這兩步。但除非維護既有系統,否則建議直接改用 FormData + fetch,程式碼更少也更可靠。