1. 程式人生 > >HTML5 FormData 方法介紹以及實現文件上傳

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

all 創建 hang function 第一個 result 實現 border 愛好

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

  這樣就可以直接通過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>

  上述代碼創建一個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;
}

  上述代碼中的 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);

?>

  填寫好信息後,點擊 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;
}

FormData 對象方法介紹

  FormData 除了上面的創建新對象時直接將 form 作為參數傳入外,還有其他的功能。網上大部分關於 FormData 介紹的文章都只提到了append()方法,那麽FormData 對象到底有些什麽方法呢?我們console 一下就知道:

技術分享

  console 之後我們有重大的發現,FormData 對象竟然有這麽方法,所以還是自己測試才能發現真相,下面就對這些方法一一進行講解:

1、append()

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

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

  fd是 FormData 對象,可以新建的空的對象,也可以是已經包含 form 表單或其他鍵值對。

2、set()

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

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

  看起來跟append() 方法有點類似,這兩者的區別就是,當指定的 key 值存在時,append()方法是將新增的所有的鍵值對添加到最後,而set()方法將會覆蓋前面設置的鍵值對。還是通過實例來對比,我們在前面的 form 的基礎上 append() 或 set() 新的鍵值對:

fd.append(name,"will");

  有兩個key為name的鍵值對:

技術分享

fd.set(name,"will");

  只有一個key為name的鍵值對:

技術分享

  以上就是 append() 和 set() 的區別。如果設置的key值不存在,那麽兩者的效果是一樣的。

3、delete()

  接收一個參數,表示你要刪除的 key 值的名字,如果有多個相同 key 值,會一並刪除:

fd.append(name,will);
fd.delete(name);
//form 中的 name 信息以及通過append() 新增的name 的信息都被刪除了。

4、get() 和 getAll()

  接收一個參數,表示需要查找的 key 的名稱,返回第一個該 key 對應的 value 值。如果有多個相同的 key, 而且要返回所有的這個 key 對應的 value 值。

  同樣以上面的 form 表單為基礎:

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

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

5、has()

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

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

6、keys()

  該方法不需要接收參數,返回一個叠代器,通過這個叠代器,我們可以遍歷FormData 對象中所有的 key。以上面的form為例:

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

/*
結果為:
name
gender
number
photo
*/

7、values()

  有遍歷 key 的叠代,當然也就少不了遍歷 value 的叠代器了。values()就是遍歷value 的叠代器,用法與 keys() 類似:

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

  結果:技術分享

8、entries()

  有遍歷 key 的叠代器,也有遍歷 value 的叠代器,為何不搞一個兩者一起的呢!entries()就是返回一個包含鍵值對的叠代器:

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

  結果:技術分享

FormData兼容性問題

  由於 FormData 是 XMLHttpRequest Level 2 新增的接口,現在 低於IE10 的IE瀏覽器不支持 FormData ,至於 上面介紹的 FormData 對象的方法經過測試,在 IE 瀏覽器中都不支持,具體的各大瀏覽器的支持情況可以參照下圖:

技術分享

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