傳統 form 提交預設會導致頁面重新整理或跳轉。若希望在使用者選擇檔案後,不離開當前頁面就完成上傳,就需要使用 iframe、FormData 或 FileReader 等技術。

以下是一個簡單的表單:
<form method="POST" action="upload" enctype="multipart/form-data"> 名字 <input type="text" name="user"> 頭像 <input type="file" name="file"> <input type="submit" id="_submit" value="提交"> </form>
若未特別處理,提交後頁面會導向 upload。

HTML5 的 FormData 可以將表單資料封裝成物件,再透過 XMLHttpRequest 送出。
document.getElementById("_submit").onclick = function(event) {
if (event.preventDefault) {
event.preventDefault();
} else {
event.returnValue = false;
}
var formDOM = document.getElementsByTagName("form")[0];
var formData = new FormData(formDOM);
var req = new XMLHttpRequest();
req.open("POST", "upload");
req.onload = function() {
if (this.status === 200) {
var img = document.createElement("img");
img.src = JSON.parse(this.responseText).path;
formDOM.insertBefore(img, document.getElementById("_submit"));
}
};
req.send(formData);
};
如果使用 jQuery,可以這樣寫:
$("#_submit").on("click", function(event) {
event.preventDefault();
var formData = new FormData($("form")[0]);
$.ajax({
url: "upload",
type: "POST",
data: formData,
contentType: false,
processData: false,
success: function(res) {
console.log(res);
}
});
});
FormData 會以 multipart/form-data 格式送出,适合上傳檔案。

若要相容舊版瀏覽器,可以建立一個隱藏的 iframe,並將表單的 target 指向它。
var iframe = document.createElement("iframe");
iframe.name = "form-iframe";
iframe.id = "form-iframe";
iframe.setAttribute("style", "width:0;height:0;border:none");
document.body.appendChild(iframe);
var form = document.getElementsByTagName("form")[0];
form.target = "form-iframe";
iframe.onload = function() {
var responseData =
this.contentDocument.body.textContent ||
this.contentWindow.document.body.textContent;
var img = document.createElement("img");
img.src = JSON.parse(responseData).path;
form.insertBefore(img, document.getElementById("_submit"));
setTimeout(function() {
var frame = document.getElementById("form-iframe");
frame.parentNode.removeChild(frame);
}, 100);
};
FileReader 可以讀取使用者選取的檔案內容,再以二進位方式送出。
var req = new XMLHttpRequest();
req.open("POST", "upload");
req.setRequestHeader("Content-Type", "application/octet-stream");
var fr = new FileReader();
fr.onload = function() {
req.sendAsBinary(this.result);
};
req.onload = function() {
console.log("上傳完成");
};
fr.readAsBinaryString(this.form["file"].files[0]);
若 sendAsBinary 不被支援,可以自己實作:
if (typeof XMLHttpRequest.prototype.sendAsBinary === "undefined") {
XMLHttpRequest.prototype.sendAsBinary = function(text) {
var data = new ArrayBuffer(text.length);
var uia = new Uint8Array(data);
for (var i = 0; i < text.length; i++) {
uia[i] = text.charCodeAt(i) & 0xff;
}
this.send(uia);
};
}
根據專案需求與瀏覽器相容性要求,選擇最合適的方案,才能兼顧開發效率與使用者體驗。