最常見的表單寫法如下:
<form action="/hehe" method="post">
<input type="text" value="hehe"/>
<input type="submit" value="upload" id="upload"/>
</form>
這種方式一定會換頁。有些時候我們希望在當前頁面就完成與伺服器的互動,送完表單後不要跳走。以下三種做法,從最取巧到最正統。
上面的程式碼完全不用改,只要補一個 iframe:
<iframe id="uploadFrame" name="uploadFrame"></iframe>
並在 form 上加上 target 屬性,讓 target 值與 iframe 的 name(或 id)一致:
<form action="/hehe" method="post" target="uploadFrame">
原理是:表單其實還是刷新了,只是刷新發生在那個看不見的 iframe 裡,對使用者來說就跟沒刷新一樣,於是產生了「非同步」的錯覺。
這不是正統做法,限制也很明顯——如果你需要在完成後取回伺服器回傳的內容,這招就完全無效。
這裡以 ajaxupload 為例,使用方式相當簡單:
<body>
<form action="/hehe" method="post">
<input type="text" value="hehe"/>
<input type="button" value="upload" id="upload"/>
</form>
<script>
(function(){
new AjaxUpload("#upload", {
action: '/hehe',
type: "post",
data: {},
name: 'textfield',
onSubmit: function(file, ext) {
alert("上傳成功");
},
onComplete: function(file, response) {
// 在這裡處理伺服器回傳的資料
}
});
})();
</script>
</body>
頁面渲染完成後,用一個立即執行的函式幫 id 為 upload 的按鈕掛上非同步上傳行為。new AjaxUpload(id, options) 的第一個參數是要綁定的元素 id;第二個參數中,data 是附帶的額外資料,name 可自訂,onSubmit 是上傳前的回呼(file 是檔名、ext 是副檔名),onComplete 則能拿到伺服器回傳的內容。
現在不需要外掛,瀏覽器原生的 FormData 加上 fetch 就能完成,而且能真正處理回應:
const form = document.querySelector('form');
form.addEventListener('submit', async (e) => {
e.preventDefault(); // 阻止表單的預設跳頁行為
const res = await fetch('/hehe', {
method: 'POST',
body: new FormData(form) // 一次帶上所有欄位與檔案
});
const data = await res.json(); // 伺服器記得回 JSON
console.log(data);
});
若要顯示上傳進度,改用 XMLHttpRequest 並監聽 upload.onprogress 事件,因為 fetch 目前不支援上傳進度回報。
思路一可以作為理解歷史的知識,思路二適用在維護既有 jQuery 專案,而新專案請直接用 FormData 加 fetch:程式碼更少、能拿到完整回應、錯誤處理也清楚得多。