先提醒一個前提:這個方案存在瀏覽器相容性問題。所幸目前主流瀏覽器的較新版本都已支援 FormData 物件,例如 Chrome 7+、Firefox 4+、IE 10+、Opera 12+、Safari 5+,若你的網站對相容性較為敏感,請審慎評估後再採用。
工作中曾遇到這樣一個情境:同一個頁面裡有四塊內容,每塊都各自帶有一個圖片上傳功能,希望做到一鍵就能把這四塊內容全部上傳。
由於上傳功能並未使用外掛,而是採用原生的 input[type=file],於是便碰到兩個難題:
其一,傳統的 form 表單提交會導致頁面刷新,無法達成上述的一鍵上傳效果;其二,若把表單用 serialize() 序列化後再以 Ajax 送出,也無法把上傳檔案的檔案流序列化,同樣行不通。
當時翻遍了資料,大致找到兩種思路:一是在 JS 中動態建立一個新 form,把原表單複製一份,再用 JS 建立一個 iframe,將表單的 target 指向 iframe,如此提交後回傳的內容會落在 iframe 裡,最後再把表單與 iframe 移除;二就是本文要介紹的 FormData 物件方案。
建立 FormData 物件有兩種途徑:一是先建立一個空物件,再用 append() 逐一塞入欄位;二是直接以既有的 HTML 表單來初始化。
第一種方式:
var oMyForm = new FormData(); oMyForm.append("username", "Groucho"); oMyForm.append("accountnum", 123456); oMyForm.append("file", $('#file')[0].files[0]); $.ajax({ url: '/Manage/UploadImg', type: 'POST', cache: false, data: oMyForm, processData: false, contentType: false, async: false }).done(function(res) {}).fail(function(res) {});
第二種方式:
<form id="uploadForm" enctype="multipart/form-data"> <p>指定文件名: <input type="text" name="filename" value="" /></p> <p>上傳文件: <input type="file" name="file" /></ p> <input type="button" value="上傳" onclick="doUpload()" /> </form>
var formData = new FormData($('#uploadForm')[0]); formData.append('num', '1');//可以在已有表單數據的基礎上,繼續添加新的鍵值對 $.ajax({ url: '/upload', type: 'POST', cache: false, data: new FormData($('#uploadForm')[0]), processData: false, contentType: false }).done(function(res) {}).fail(function(res) {});
前端搞定後,剩下的就是後端處理。以下再補充兩種更具體的情境。
HTML 代碼:
<form id="uploadForm" enctype="multipart/form-data"> <input id="file" type="file" name="file"/> <button id="upload" type="button">upload</button> </form>
JavaScript 代碼:
$.ajax({ url: '/upload', type: 'POST', cache: false, data: new FormData($('#uploadForm')[0]), processData: false, contentType: false }).done(function(res) { }).fail(function(res) {});
這裡同樣要注意:processData 設為 false;<form> 標籤加上 enctype="multipart/form-data";cache 設為 false;contentType 設為 false。上傳完成後,伺服器端可透過參數名 file 取得檔案輸入流物件,因為 <input> 中宣告的是 name="file"。
HTML 代碼:
<div id="uploadForm"> <input id="file" type="file"/> <button id="upload" type="button">upload</button> </div>
這裡沒有 <form> 標籤,也沒有 enctype 屬性。
JavaScript 代碼:
var formData = new FormData(); formData.append('file', $('#file')[0].files[0]); $.ajax({ url: '/upload', type: 'POST', cache: false, data: formData, processData: false, contentType: false }).done(function(res) { }).fail(function(res) {});
與前者的差異在於:append() 的第二個參數要是檔案物件,即 $('#file')[0].files[0];contentType 同樣要設為 false。
從 $('#file')[0].files[0] 的寫法可以看出,只要為 <input type="file"> 加上 multiple 或 multiple="multiple" 屬性,就能一次上傳多個檔案。
從 Servlet 3.0 起,可以透過 request.getPart() 或 request.getParts() 兩個介面取得上傳的檔案。關於這部分的細節,可參考官方教學文件。
以上就是以 Ajax 搭配 FormData 實現無刷新上傳的完整說明,希望對你的學習有所幫助。