傳統的表單上傳一提交就整頁跳轉,體驗很差。要做到無刷新上傳並順帶預覽效果,只需要兩個原生對象:FormData 負責組織並發送數據,FileReader 負責把本地圖片讀成可顯示的 Data URL。
先準備表單和一個用來放預覽圖的容器:
<form enctype="multipart/form-data" id="oForm"> <input type="file" name="file" id="file" onchange="readAsDataURL()" /> <input type="button" value="提交" onclick="doUpload()" /> </form> <div> <img alt="" id="img" /> </div>
FormData 用來組裝一組將由 XMLHttpRequest 發送的鍵值對。它的靈活之處在於可以完全脫離表單 DOM 獨立使用;而如果表單的 enctype 設置為 multipart/form-data,那麼通過 FormData 傳輸的數據格式與表單 submit() 的格式完全一致。
在這裡,我們用 FormData 直接接過整個 form 元素,一次性拿到裡面所有字段,再交給 ajax 發送。這樣就繞開了原生提交必然導致的頁面跳轉。
function doUpload() {
var formData = new FormData($('#oForm')[0);
console.log(formData);
$.ajax({
url: 'pp',
type: 'POST',
data: formData,
async: false,
cache: false,
contentType: false, // 不設置 Content-Type,讓瀏覽器自動帶上 boundary
processData: false, // 不把 data 序列化成字符串
success: function (returndata) {
console.log(returndata);
},
error: function (returndata) {
console.log(returndata);
}
});
}
這裡有兩個必須注意的選項:processData: false 阻止 jQuery 把 FormData 轉成 query 字符串,contentType: false 讓瀏覽器自行生成帶 boundary 的 Content-Type。少寫任何一個,後端都收不到文件。
FileReader 允許 Web 應用異步讀取用戶本地文件的內容,通過 File 或 Blob 對象指定目標。我們用它把選中的圖片轉成 Data URL,塞進預先準備好的 img 容器裡。
function readAsDataURL() {
var file = document.getElementById('file').files[0];
// 先校驗是否為圖像文件
if (!/image\/\w+/.test(file.type)) {
alert('看清楚,這個需要圖片!');
return false;
}
var reader = new FileReader();
reader.readAsDataURL(file); // 以 Data URL 形式讀入
reader.onload = function (e) {
var result = document.getElementById('img');
result.src = this.result; // 顯示文件
};
}
用戶點擊文件框選圖 → input 觸發 change → readAsDataURL 校驗類型並異步讀取 → onload 中把 Data URL 賦給 img.src,預覽即刻呈現 → 用戶確認無誤後點擊提交 → doUpload 用 FormData 打包表單交給 ajax,全程頁面不動。
兩個對象各司一職,代碼量很小,卻把「先看看再傳」這個體驗提升做完整了。需要注意的是,基於 file.type 的前端校驗只是第一道關卡,真正的文件類型與大小驗證必須在服務端再做一次。