DIV CSS 佈局教程網

用 Ajax 搭配 FormData 物件實現無刷新檔案上傳
編輯:JQuery入門技巧     

先提醒一個前提:這個方案存在瀏覽器相容性問題。所幸目前主流瀏覽器的較新版本都已支援 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 物件的兩種方式

建立 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) {});

幾個關鍵注意事項

  • 要把 Ajax 的 processData 設為 false,因為 data 已是 FormData 物件,不需要再對資料做額外處理。
  • 第二種方式需在 <form> 標籤上加上 enctype="multipart/form-data" 屬性。
  • cache 設為 false,因為上傳檔案不需要快取。
  • contentType 設為 false。由於 FormData 是由表單構造並已宣告 enctype="multipart/form-data",這裡設為 false 讓瀏覽器自行帶入正確的邊界資訊。

前端搞定後,剩下的就是後端處理。以下再補充兩種更具體的情境。

以表單初始化 FormData 上傳檔案

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"。

不透過表單,直接用 FormData 添加欄位

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 實現無刷新上傳的完整說明,希望對你的學習有所幫助。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved