在尚未普遍使用 FormData 與 Ajax 的年代,要「不刷新頁面」地上傳檔案,標準做法是借用 iframe:把表單的 target 指向一個隱藏的 iframe,送出後頁面本身不會跳走,再從 iframe 中讀取伺服器回應。
若要更完整的進度條與多檔上傳體驗,可以參考 uploadify 這類 Flash 時代的第三方插件(https://www.uploadify.com/)。以下示範純手寫版本。
・用 JavaScript 建立 form 與 iframe 並加入 body,form 的 target 必須與 iframe 的 name 一致。
・在 form 中放入要送出的欄位,呼叫 submit 送出。
・若要上傳檔案,在 form 內加入 input[type=file],並在其 onchange 中觸發 submit。
・關於回呼:iframe 送出後,伺服器的回應會成為 iframe 內頁面的內容,可以這樣取得並解析:$iframe[0].contentWindow.document.querySelector('body').innerHTML
var target = 'frameFile';
var input = '<input type="file" name="file" onchange="changeImage()">' +
'<input name="appId" value="' + id + '">' +
'<input type="submit" name="submit" value="submit">';
var $form = $('<form action="' + url + '" target="' + target + '" ' +
'enctype="multipart/form-data" method="post" id="upImageForm" ' +
'style="display:none">' + input + '</form>').appendTo('body');
var $iframe = $('<iframe name="' + target + '" style="display:none"></iframe>').appendTo('body');
$form.find('input').eq(0).click();
window.changeImage = function () {
$form.find('input').eq(-1).click();
};
// 監聽 iframe 的載入完成
$iframe.load(function (e) {
var str = $iframe[0].contentWindow.document.querySelector('body').innerHTML;
var data = spt(str);
$form.remove();
$iframe.remove();
callback(data);
});
// 把回傳的字串拆成物件
function spt(str) {
var a = str.indexOf('{');
var b = str.indexOf('}');
var j = {};
var t = [];
var s = str.substring(a + 1, b);
s = s.replace(/"/gi, '');
t = s.split(',');
for (var i = 0; i < t.length; i++) {
var tmp = t[i].split(':');
j[tmp[0]] = tmp[1];
}
return j;
}
上述程式碼在「改動 input[type=file] 的 onchange 並在其中 submit」這一步有明顯缺陷:onchange 是在使用者選檔「開始」時觸發,此時檔案其實還沒選完,submit 就已經送出了。此外, dynamically 建立的 form 元素在部分瀏覽器中無法正常承載檔案上傳,實務上建議直接把 form 寫在 HTML 裡,而不是用 JavaScript 動態產生。
另外,用字串拆解 JSON 的 spt 函式非常脆弱:值裡只要出現逗號或冒號就會解析錯誤。伺服器既然回傳 JSON,就應該用 JSON.parse 處理,並在伺服器端設定 Content-Type: application/json。
這個技巧現在幾乎沒有使用必要。用 FormData 就能以標準 Ajax 上傳檔案,並可監聽進度:
var fd = new FormData();
fd.append('file', document.querySelector('input[type=file]').files[0]);
fd.append('appId', id);
var xhr = new XMLHttpRequest();
xhr.open('POST', url, true);
xhr.upload.onprogress = function (e) {
if (e.lengthComputable) {
console.log((e.loaded / e.total * 100).toFixed(1) + '%');
}
};
xhr.onload = function () {
if (xhr.status === 200) {
callback(JSON.parse(xhr.responseText));
}
};
xhr.send(fd);
注意使用 FormData 時不要手動設定 Content-Type,瀏覽器會自動補上 boundary。若用 jQuery,則需同時設定 processData: false 與 contentType: false。
至於跨網域上傳,iframe 這招也早已被 CORS 取代:由伺服器回應 Access-Control-Allow-Origin 標頭即可。iframe 方案還有一個致命限制——若伺服器與頁面不同源,同源政策會讓你完全讀不到 iframe 內的內容,也就是說它只能做到「送出」,做不到「取得回應」。