通過Ajax使用FormData對象無刷新上傳文件方法

2019-11-19 18:36:10

字體：大中小

來源：轉載

供稿：網友

寫在前面：本文說的這個方案有瀏覽器兼容性問題；所有主流瀏覽器的較新版本已經支持這個對象了，比如Chrome 7+、Firefox 4+、IE 10+、Opera 12+、Safari 5+，對兼容性比較敏感的網站慎用。

在工作中遇到了一個問題：在一個頁面中，有4塊內容，每塊內容都包含一個圖片上傳功能，希望可以實現一鍵把這四塊內容都上傳上去。

我沒有用插件實現上傳功能，就是用的input[type=file]，因此就遇到一個問題就是：

①傳統的form表單會導致頁面刷新，無法實現上述功能

②把表單serialize()序列化用Ajax的方式提交，也無法把上傳文件的文件流進行序列化，也不行

我現有的知識就搞不定了，只能求助網上的大神了，百度了一下，大概看了兩個方案：

①在js中創建一個新form表單，把頁面中原form表單copy一份，然后再用js搞一個iframe，把form表單的target設置為iframe，這樣提交后返回的內容就在iframe里，最后再把form表單、iframe移除

②就是本文下面要說的使用FormData對象實現

有其他思路方案的希望不吝賜教！

好，介紹完背景之后，開始介紹我們今天的主題：FormData對象。

有兩種方式可以創建一個FormData對象：

①創建一個空的FormData對象，然后使用append()方法向該對象里添加字段

②使用HTML表單來初始化一個FormData對象

下面分別介紹一下：

第一種方式：

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>標簽加enctyp　　e="multipart/form-data"屬性。
cache設置為false，上傳文件不需要緩存。
contentType設置為false。因為是由<form>表單構造的FormData對象，且已經聲明了屬性enctype="mutipart/form-data"，所以這里設置為false。

前端搞定之后，剩下的就是后端處理了。ok，就到這里了。

FormData對象，是可以使用一系列的鍵值對來模擬一個完整的表單，然后使用XMLHttpRequest發送這個"表單"。

在 Mozilla Developer 網站使用FormData對象有詳盡的FormData對象使用說明。

但上傳文件部分只有底層的XMLHttpRequest對象發送上傳請求，那么怎么通過jQuery的Ajax上傳呢？

本文將介紹通過jQuery使用FormData對象上傳文件。

使用<form>表單初始化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。因為data值是FormData對象，不需要對數據做處理。
<form>標簽添加enctype="multipart/form-data"屬性。
cache設置為false，上傳文件不需要緩存。
contentType設置為false。因為是由<form>表單構造的FormData對象，且已經聲明了屬性enctype="multipart/form-data"，所以這里設置為false。

上傳后，服務器端代碼需要使用從查詢參數名為file獲取文件輸入流對象，因為<input>中聲明的是name="file"。

如果不是用<form>表單構造FormData對象又該怎么做呢？

使用FormData對象添加字段方式上傳文件

HTML代碼

<div id="uploadForm"> <input id="file" type="file"/> <button id="upload" type="button">upload</button></div>

這里沒有<form>標簽，也沒有enctype="multipart/form-data"屬性。

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

這里有幾處不一樣：