DIV CSS 佈局教程網

為 jQuery ajaxfileupload 加上額外參數的改造方法
編輯:JavaScript綜合知識     

ajaxfileupload 是 jQuery 時代常見的無外掛檔案上傳方案,原理是建立隱藏 iframe,讓表單以一般 submit 送出後,再把 iframe 中的回應取出來,藉此模擬 AJAX。但它預設只送檔案,不支援附加參數。以下是擴充方式。

呼叫時傳入 data

$.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);
    // ...
}

改完這兩處,附加參數就會以隱藏欄位的形式隨表單一起送出,後端用一般表單參數接收即可。

幾個必須注意的問題

  • 值必須轉義:上面用字串拼接組 HTML,若 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 方案對大檔案與非同步進度回報支援很差,無法顯示上傳進度條。
  • 回應格式限制:從 iframe 取回應時,瀏覽器會依 iframe 文件的 Content-Type 決定如何解析,某些情況需要特別處理。

現代替代方案

這個外掛的 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,程式碼更少也更可靠。

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