DIV CSS 佈局教程網

用 AjaxFileUpload.js 實作非同步檔案上傳
編輯:AJAX基礎知識     

Ajax 本身無法提交檔案。因此在需要「上傳圖片並預覽」的舊時代,常見做法是塞一個隱藏 iframe,讓表單提交到 iframe 裡,製造出看似非同步的效果。這種做法能用,但要自己管理 iframe 的建立、輪替與清理,相當麻煩。

ajaxfileupload.js 就是把這一切包裝起來,讓你不必碰 iframe 的任何細節,也不必為了它調整頁面結構。

HTML

<input type="file" name="upload" hidden="hidden"
       id="file_upload" accept=".zip" />

JavaScript

$.ajaxFileUpload({
    url: '${pageContext.request.contextPath}/Manage/BR_restorePic.action',
    secureuri: false,          // 是否需要安全協議,一般設為 false
    fileElementId: 'file_upload',  // 檔案選擇框的 id
    dataType: 'text',          // 伺服器回傳格式,可以是 json 或 xml
    success: function (data, status) {
        // 相當於 try 區塊
        $('#restoreDialog').html(data);
    },
    error: function (data, status, e) {
        // 相當於 catch 區塊
        $('#restoreDialog').html("上傳失敗,請重試");
    }
});

參數說明:fileElementId 指向檔案選擇框的 id;dataType 決定 jQuery 如何解析回應;secureuri 在 HTTPS 環境下某些舊瀏覽器需要設為 true,一般情況設 false 即可。

一個容易忽略的問題:input 只能用一次

這個方法有個副作用——同一個 file input 的第二次 onchange 不會被觸發。這與瀏覽器的檔案選擇安全性機制有關:為了避免程式在未經使用者動作的情況下反覆觸發選擇框,瀏覽器會限制同一元素的 repeat 行為。

解法很直接:每次上傳完就把這個 input 整個換掉,讓下一次是一個全新的元素。

$('#file_upload').replaceWith(
    '<input type="file" name="upload" hidden="hidden" id="file_upload" accept=".zip" />'
);

這行應該放在 success 與 error 兩個回呼的最後,確保不論成功或失敗,下一次上傳都能正常運作。若只放在 success 裡,一旦上傳失敗,使用者就會發現檔案選單點不動了。

幾點實務提醒

後端要限制檔案型別與大小。前端 accept=".zip" 只是提示,可以被輕易繞過。副檔名白名單與大小上限必須在伺服器端驗證,並建議重新命名檔案、把上傳目錄設為不可執行。

回應格式要與 dataType 一致。由於底層是 iframe 提交,回應通常是 HTML 片段;若宣告 dataType: 'json' 卻回傳純文字,jQuery 解析會失敗並進入 error 回呼。

新專案不必再用這個套件。今日瀏覽器普遍支援 FormData 與 XMLHttpRequest 的進度事件,直接用 $.ajax({ data: new FormData(...), processData: false, contentType: false }) 就能真正非同步上傳,還能顯示上傳進度百分比。ajaxFileUpload.js 的價值主要在維護舊系統。

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