Ajax 本身無法提交檔案。因此在需要「上傳圖片並預覽」的舊時代,常見做法是塞一個隱藏 iframe,讓表單提交到 iframe 裡,製造出看似非同步的效果。這種做法能用,但要自己管理 iframe 的建立、輪替與清理,相當麻煩。
ajaxfileupload.js 就是把這一切包裝起來,讓你不必碰 iframe 的任何細節,也不必為了它調整頁面結構。
<input type="file" name="upload" hidden="hidden"
id="file_upload" accept=".zip" />
$.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 即可。
這個方法有個副作用——同一個 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 的價值主要在維護舊系統。