DIV CSS 佈局教程網

serialize() 與 FormData:AJAX 表單序列化上傳檔案
編輯:AJAX基礎知識     

傳統表單提交

<form id="uploadForm" action="" method="post" enctype="multipart/form-data">
  <p>上傳檔案:<input type="file" name="file" /></p>
  <input type="submit" value="上傳" />
</form>

這種寫法最直接,但缺點也很明顯:提交會導致頁面刷新。很多時候我們不希望畫面被帶走,這時就要改用 AJAX。

用 serialize() 序列化表單

$.ajax({
    url: "",
    type: "POST",
    data: $('#uploadForm').serialize(),
    success: function (data) { },
    error: function (data) { }
});

$('#uploadForm').serialize() 會把表單中所有欄位打包成 key=value&key2=value2 的查詢字串,一次送到後端,不必逐一取值。

但它有個明確的限制:檔案內容無法被序列化。序列化的結果只有 <input type="file"> 的欄位名稱,檔案本身的二進位內容會被丟掉。這是許多人卡住的地方。

改用 FormData 完成檔案上傳

如今主流瀏覽器都支援 FormData 物件,有了它就能輕鬆用 AJAX 上傳檔案。

<form id="uploadForm">
  <p>上傳檔案:<input type="file" name="file" /></p>
  <input type="button" value="上傳" onclick="upload()" />
</form>

<script>
function upload() {
    // 直接把表單元素丟進建構子,它會自動收集所有欄位(含檔案)
    var formData = new FormData($("#uploadForm")[0]);

    $.ajax({
        url: '',
        type: 'POST',
        data: formData,
        async: false,
        cache: false,
        contentType: false,    // 讓瀏覽器自行產生帶 boundary 的 Content-Type
        processData: false,    // 不要把資料轉成字串
        success: function (data) { },
        error: function (data) { }
    });
}
</script>

三個設定的作用值得逐一釐清:

processData: false 預設情況下 jQuery 會把 data 轉成查詢字串,這對 FormData 是災難性的。關掉它,資料才會原封不動送出。

contentType: false 若讓 jQuery 自行設定,它會寫上 application/x-www-form-urlencoded 卻沒有 boundary,後端無法切割出檔案。設為 false 之後,瀏覽器會自動補上正確的 multipart/form-data; boundary=...。

cache: false 避免上傳結果被快取,除錯時特別有用。

至於範例中的 async: false,除非有特殊的順序依賴需求,否則建議改回預設的異步——同步請求會讓整個瀏覽器分頁凍結直到回應回來,在現代前端開發中已不建議使用。

小結:純文字欄位用 serialize() 就夠;一旦涉及檔案,FormData 搭配 processData: false 與 contentType: false 是唯一正解。把這三者的關係記住,檔案上傳就不會再出問題。

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