DIV CSS 佈局教程網

仿 iframe 實現 Ajax 文件上傳:兼容舊瀏覽器的思路
編輯:JQuery入門技巧     

用 $.post 傳文本毫無問題,但直接上傳文件卻行不通——根源在於文件內容是二進制,而 $.post 默認的表單編碼承載不了。

曾經的解法有兩類:一是用現成的 ajax 上傳封裝庫,二是借助 Flash。Flash 效果確實好,但門檻在於並非每個人都會寫 ActionScript,下載到的現成方案要改造成符合自己項目結構的代碼也不輕鬆,體積還不小。

最後我選擇了模擬 iframe 的方案,實現起來出乎意料地簡單,思路是:把表單的 target 指向一個隱藏的 iframe,讓文件在 iframe 裡完成提交,父頁面則保持不刷新。

HTML 結構

<iframe name="ajaxUpload" style="display:none"></iframe>

<form name="from1" id="from1" method="post" action="url"
      enctype="multipart/form-data" target="ajaxUpload">
  <table>
    <tr>
      <td>附件:</td>
      <td><input type="file" id="document" name="document" /></td>
    </tr>
  </table>
</form>

這裡有兩個重點:enctype="multipart/form-data" 不可省略,否則文件內容會被當作普通文本處理;target 的值必須等於 iframe 的 name,提交才會發生在 iframe 內部而不是當前頁面。

JS:觸發表單提交

$(function () {
    if ($.browser.msie) {
        window.form1.submit();
    } else {
        $("#form1").submit();
    }
});

這裡做了瀏覽器判斷,因為 IE(尤其 IE6)對 $("#idName").submit() 這種 jQuery 方式的支持不夠規範,需要退回原生 form.submit()。順帶一提,$.browser 已在 jQuery 1.9 中移除,新項目中請改用特性檢測或 document.forms['from1'].submit() 這類通用寫法。

服務端:必須回寫一段腳本把結果送回父頁

因為提交發生在 iframe 中,服務端的響應會渲染到 iframe 裡,父頁感知不到。要讓父頁知道結果,需要在響應中寫一段調用父頁面的腳本。

public void Upload()
{
    HttpPostedBase ff = Request.Files["document"];   // 也可用索引取值
    string fileName = System.DateTime.Now + ff.FileName;
    // 注意:取到的文件名不含擴展名,保存時需另行提取後綴
    try
    {
        SaveAs(documentPath + fileName + extendtionName);
        Response.Write("<script type='text/javascript'>parent.window.callBackMethod('上傳成功');</script>");
    }
    catch
    {
        Response.Write("<script type='text/javascript'>parent.window.callBackMethod('上傳失敗');</script>");
    }
}

其中 parent.window.callBackMethod() 是 iframe 調用父頁方法的關鍵。整個流程是:父頁點擊上傳 → 通過 target 把表單提交進 iframe → iframe 把文件 POST 到服務端 → 服務端處理後響應 → 響應的腳本在 iframe 中執行,反向調用父頁的 callBackMethod 完成提示或界面更新。

如果只需要彈個 alert 提示結果,其實不調父頁方法也行;但若想在父頁彈出一個自定義的對話框(例如那種藍色的登陸框風格),就必須走這一步。

為什麼說它「像局部刷新」

本質上這仍然是頁面跳轉,只不過跳轉發生在一個沒有內容、且 display:none 的 iframe 裡。因為它不可見,刷新過程完全不影響整個頁面的呈現,視覺上就等同於局部更新。

這個方案的優缺點

優點:零依賴、兼容極老的瀏覽器、代碼量極少、不需要任何插件。

缺點:沒有原生上傳進度(進度條需要額外配合 Flash 或純前端的 XHR 方案);錯誤處理依賴字符串拼接的腳本回調,調試不便;多文件上傳需要動態生成多個 file input。

在今天,這個方案主要作為「必須兼容 IE8 及以下」時的兜底手段。現代項目直接使用 FormData 加 XHR Level 2 即可,代碼更短、能力更強,還能顯示進度。

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