[轉] HTML5 FormData 方法介紹以及實現文件上傳

XMLHttpRequest 是一個瀏覽器接口，經過它，咱們可使得 Javascript 進行 HTTP (S) 通訊。XMLHttpRequest 在如今瀏覽器中是一種經常使用的先後臺交互數據的方式。2008年 2 月，XMLHttpRequest Level 2 草案提出來了，相對於上一代，它有一些新的特性，其中 FormData 就是 XMLHttpRequest Level 2 新增的一個對象，利用它來提交表單、模擬表單提交，固然最大的優點就是能夠上傳二進制文件。下面就具體介紹一下如何利用 FormData 來上傳文件。

FormData 上傳文件實例

首先看一下formData的基本用法：FormData對象，能夠把全部表單元素的name與value組成一個queryString，提交到後臺。只須要把 form 表單做爲參數傳入 FormData 構造函數便可：

var form = document.getElementById("form1"); var fd = new FormData(form);

• 1
• 2

這樣就能夠直接經過ajax 的 send() 方法將 fd 發送到後臺。

如下建立了一個表單 form，表單中除了普通的數據外，還有文件上傳，咱們直接將 form對象做爲參數傳入FormData對象：

<form name="form1" id="form1"> <p>name:<input type="text" name="name" /></p> <p>gender:<input type="radio" name="gender" value="1" />male <input type="radio" name="gender" value="2" />female</p> <p>stu-number：<input type="text" name="number" /></p> <p>photo:<input type="file" name="photo" id="photo"></p> <p><input type="button" name="b1" value="submit" onclick="fsubmit()" /></p> </form> <div id="result"></div>

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8

上述代碼建立一個form，簡單的填寫一些信息，以及選擇一張圖片做爲頭像，設置一個div來存放返回的結果。

爲了簡便，咱們仍是採用jquery封裝的ajax來向後臺傳輸數據：

function fsubmit() { var form=document.getElementById("form1"); var fd =new FormData(form); $.ajax({ url: "server.php", type: "POST", data: fd, processData: false, // 告訴jQuery不要去處理髮送的數據 contentType: false, // 告訴jQuery不要去設置Content-Type請求頭 success: function(response,status,xhr){ console.log(xhr); var json=$.parseJSON(response); var result = ''; result +="我的信息：<br/>name:"+json['name']+"<br/>gender:"+json['gender']+"<br/>number:"+json['number']; result += '<br/>頭像：<img src="' + json['photo'] + '" height="100" style="border-radius: 50%;" />'; $('#result').html(result); } }); return false; } 

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21

上述代碼中的 server.php 是服務器端的文件，接收ajax請求，並將接收結果返回，具體代碼以下：

<?php $name = isset($_POST['name'])? $_POST['name'] : ''; $gender = isset($_POST['gender'])? $_POST['gender'] : ''; $number = isset($_POST['number'])? $_POST['number'] : ''; $filename = time().substr($_FILES['photo']['name'], strrpos($_FILES['photo']['name'],'.')); $response = array(); if(move_uploaded_file($_FILES['photo']['tmp_name'], $filename)){ $response['isSuccess'] = true; $response['name'] = $name; $response['gender'] = $gender; $response['number'] = $number; $response['photo'] = $filename; }else{ $response['isSuccess'] = false; } echo json_encode($response); ?> 

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21

填寫好信息後，點擊 submit，頁面中能獲得如下效果，去服務器端對應的文件夾下也能發現上傳的圖片。

若是你是原生 JavaScript 愛好者，固然同樣能實現以上功能，下面是簡單的JavaScript實現代碼：

function fsubmit() { var form=document.getElementById("form1"); var formData=new FormData(form); alert(formData.name); var oReq = new XMLHttpRequest(); oReq.onreadystatechange=function(){ if(oReq.readyState==4){ if(oReq.status==200){ console.log(typeof oReq.responseText); var json=JSON.parse(oReq.responseText); var result = ''; result +="我的信息：<br/>name:"+json['name']+"<br/>gender:"+json['gender']+"<br/>number:"+json['number']; result += '<br/>頭像：<img src="' + json['photo'] + '" height="50" style="border-radius: 50%;" />'; $('#result').html(result); } } }; oReq.open("POST", "server.php"); oReq.send(formData); return false; }

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22

FormData 對象方法介紹

FormData 除了上面的建立新對象時直接將 form 做爲參數傳入外，還有其餘的功能。網上大部分關於 FormData 介紹的文章都只提到了append()方法，那麼FormData 對象到底有些什麼方法呢？咱們console 一下就知道：

console 以後咱們有重大的發現，FormData 對象居然有這麼方法，因此仍是本身測試才能發現真相，下面就對這些方法一一進行講解：

一、append()

append()方法用於向 FormData 對象中添加鍵值對：

fd.append('key1',"value1"); fd.append('key2',"value2");

• 1
• 2

fd是 FormData 對象，能夠新建的空的對象，也能夠是已經包含 form 表單或其餘鍵值對。

二、set()

設置對應的鍵 key 對應的值 value(s)

fd.set('key1',"value1"); fd.set('key2',"value2");

• 1
• 2

看起來跟append() 方法有點相似，這二者的區別就是，當指定的 key 值存在時，append()方法是將新增的添加的因此的鍵值對最後，而set()方法將會覆蓋前面的設置的鍵值對。仍是經過實例來對比，咱們在前面的 form 的基礎上 append() 或 set() 新的鍵值對：

fd.append('name',"will");

• 1

有兩個key爲name的鍵值對： 

fd.set('name',"will");

• 1

只有一個key爲name的鍵值對： 

以上就是 append() 和 set() 的區別。若是設置的key值不存在，那麼二者的效果是同樣的。

三、delete()

接收一個參數，表示你要刪除的 key 值的名字，若是有多個相同 key 值，會一併刪除：

fd.append('name','will'); fd.delete('name');

• 1
• 2

form 中的 name 信息以及經過append() 新增的name 的信息都被刪除了。

四、get() 和 getAll()

接收一個參數，表示須要查找的 key 的名稱，返回第一個該 key 對應的 value 值。若是有多個相同的 key， 並且要返回全部的這個 key 對應的 value 值。

一樣以上面的 form 表單爲基礎：

fd.append('name','will'); console.log(fd.get('name')); // sean

• 1
• 2

fd.append('name','will'); console.log(fd.getAll('name')); // ["sean", "will"]

• 1
• 2

五、has()

該方法也接收一個參數，一樣是 key 的名稱，返回一個Boolean 值， 用來判斷FormData 對象是否含有該 key。以上面的form爲例：

console.log(fd.has('name')); // true console.log(fd.has('Name')); // false

• 1
• 2

六、keys()

該方法不須要接收參數，返回一個迭代器，經過這個迭代器，咱們能夠遍歷FormData 對象中全部的 key。以上面的form爲例：

for (var key of fd.keys()) { console.log(key); }

• 1
• 2
• 3

結果爲：

name gender number photo

• 1
• 2
• 3
• 4

七、values()

有遍歷 key 的迭代，固然也就少不了遍歷 value 的迭代器了。values()就是遍歷value 的迭代器，用法與 keys() 相似：

for (var value of fd.values()) { console.log(value); }

• 1
• 2
• 3

結果：

八、entries()

有遍歷 key 的迭代器，也有遍歷 value 的迭代器，爲什麼不搞一個二者一塊兒的呢！entries()就是返回一個包含鍵值對的迭代器：

for(var pair of fd.entries()) { console.log(pair[0]+ ', '+ pair[1]); }

• 1
• 2
• 3

結果：

FormData兼容性問題

因爲 FormData 是 XMLHttpRequest Level 2 新增的接口，如今 低於IE10 的IE瀏覽器不支持 FormData ，至於 上面介紹的 FormData 對象的方法通過測試，在 IE 瀏覽器中都不支持，具體的各大瀏覽器的支持狀況能夠參照下圖：