DIV CSS 佈局教程網

iframe、FormData 與 FileReader 三種無刷新上傳檔案的方法
編輯:關於JavaScript     

為什麼需要無刷新上傳

傳統 form 提交預設會導致頁面重新整理或跳轉。若希望在使用者選擇檔案後,不離開當前頁面就完成上傳,就需要使用 iframe、FormData 或 FileReader 等技術。

傳統 form 提交的問題

以下是一個簡單的表單:

<form method="POST" action="upload" enctype="multipart/form-data">
  名字 <input type="text" name="user">
  頭像 <input type="file" name="file">
  <input type="submit" id="_submit" value="提交">
</form>

若未特別處理,提交後頁面會導向 upload。

方式一:使用 FormData

HTML5 的 FormData 可以將表單資料封裝成物件,再透過 XMLHttpRequest 送出。

document.getElementById("_submit").onclick = function(event) {
  if (event.preventDefault) {
    event.preventDefault();
  } else {
    event.returnValue = false;
  }

  var formDOM = document.getElementsByTagName("form")[0];
  var formData = new FormData(formDOM);
  var req = new XMLHttpRequest();

  req.open("POST", "upload");

  req.onload = function() {
    if (this.status === 200) {
      var img = document.createElement("img");
      img.src = JSON.parse(this.responseText).path;
      formDOM.insertBefore(img, document.getElementById("_submit"));
    }
  };

  req.send(formData);
};

如果使用 jQuery,可以這樣寫:

$("#_submit").on("click", function(event) {
  event.preventDefault();

  var formData = new FormData($("form")[0]);

  $.ajax({
    url: "upload",
    type: "POST",
    data: formData,
    contentType: false,
    processData: false,
    success: function(res) {
      console.log(res);
    }
  });
});

FormData 會以 multipart/form-data 格式送出,适合上傳檔案。

方式二:使用隱藏 iframe

若要相容舊版瀏覽器,可以建立一個隱藏的 iframe,並將表單的 target 指向它。

var iframe = document.createElement("iframe");
iframe.name = "form-iframe";
iframe.id = "form-iframe";
iframe.setAttribute("style", "width:0;height:0;border:none");
document.body.appendChild(iframe);

var form = document.getElementsByTagName("form")[0];
form.target = "form-iframe";

iframe.onload = function() {
  var responseData =
    this.contentDocument.body.textContent ||
    this.contentWindow.document.body.textContent;

  var img = document.createElement("img");
  img.src = JSON.parse(responseData).path;
  form.insertBefore(img, document.getElementById("_submit"));

  setTimeout(function() {
    var frame = document.getElementById("form-iframe");
    frame.parentNode.removeChild(frame);
  }, 100);
};

方式三:使用 FileReader

FileReader 可以讀取使用者選取的檔案內容,再以二進位方式送出。

var req = new XMLHttpRequest();
req.open("POST", "upload");
req.setRequestHeader("Content-Type", "application/octet-stream");

var fr = new FileReader();

fr.onload = function() {
  req.sendAsBinary(this.result);
};

req.onload = function() {
  console.log("上傳完成");
};

fr.readAsBinaryString(this.form["file"].files[0]);

若 sendAsBinary 不被支援,可以自己實作:

if (typeof XMLHttpRequest.prototype.sendAsBinary === "undefined") {
  XMLHttpRequest.prototype.sendAsBinary = function(text) {
    var data = new ArrayBuffer(text.length);
    var uia = new Uint8Array(data);

    for (var i = 0; i < text.length; i++) {
      uia[i] = text.charCodeAt(i) & 0xff;
    }

    this.send(uia);
  };
}

三種方式比較

  • iframe:相容性最好,但需要建立與移除額外 DOM。
  • FormData:寫法最簡單,适合現代瀏覽器。
  • FileReader:最靈活,可自訂上傳格式與分段處理。

根據專案需求與瀏覽器相容性要求,選擇最合適的方案,才能兼顧開發效率與使用者體驗。

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