開發時遇到這樣一個需求:要把 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 要隱藏。
$(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 方案的主要價值在於支援相當舊的瀏覽器。