DIV CSS 佈局教程網

無重新載入上傳檔案並回傳自訂訊息的做法
編輯:關於JavaScript     

開發時遇到這樣一個需求:要把 Excel 上傳到伺服器解析,但當檔案不符合條件時,希望不刷新頁面就提示使用者。研究網路資料並實測之後,找到一個不需要額外套件就能解決的辦法,記錄如下。

思路

在頁面上放一個隱藏的 iframe,把 form 的 target 指向該 iframe 的 id。這樣表單送出時,Excel 會以檔案流的形式傳到後端,後端接收後進行自訂處理,而回應內容會顯示在 iframe 裡,不會造成頁面跳轉。由於 iframe 是隱藏的,使用者看不到任何變化。接著我們監聽 iframe 內容的變化,把內容取出來傳給主視窗的 JavaScript 方法,做下一步處理。

這個技巧的本質是「借用 iframe 當作一個隱形的回應容器」,避開了 XHR 無法傳送檔案的歷史限制(在 FormData 普及之前,這是標準解法)。

頁面程式碼

<form id="input" action="importExcel.jhtml" method="post" enctype="multipart/form-data" target="hiddenIFrame">
  <input id="excelFile" name="file" type="file" />
  <input type="submit" class="button" value="導入excel" />
</form>
<iframe id="hiddenIFrame" name="hiddenIFrame" style="display:none;"></iframe>

三個屬性缺一不可:enctype 必須是 multipart/form-data,target 要對應 iframe 的 name,而 iframe 要隱藏。

前端 JavaScript(需引入 jQuery)

$(function () {
  $("#hiddenIFrame").load(function () {
    var wnd = this.contentWindow;
    var str = $(wnd.document.body).html();
    callback(str);
  });
});

function callback(info) {
  alert(info);
}

load 事件在 iframe 內容載入完成時觸發,也就是後端回應抵達的時刻。取出 body 的 HTML 後交給 callback,就能依照回傳內容決定要提示什麼、或要更新哪個區塊。

後端

後端的處理方式與傳統送出完全一樣:依 input 元件的 name 屬性取得同名的檔案流(上例中 name 是 file,後端收到的就是名為 file 的檔案流),接收後即可自訂解析與驗證邏輯,最後把結果寫入回應。

幾個實務提醒

第一,iframe 內回應的內容型別會影響取值的難易度。若後端回傳的是完整 HTML 文件,用 $(wnd.document.body).html() 取值即可;若只是純文字訊息,直接讀 body 的內容更乾淨,不必多一層解析。

第二,記得在 callback 裡把 iframe 清空。否則同一個 iframe 連續上傳兩次,第二次的 load 事件可能帶著前一次殘留的內容,造成誤判。

第三,若這個專案已經可以用 FormData 搭配 $.ajax(並設定 processData: false 與 contentType: false),那就沒有必要繞 iframe 這一圈了。iframe 方案的主要價值在於支援相當舊的瀏覽器。

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