<form id="uploadForm" action="" method="post" enctype="multipart/form-data"> <p>上傳檔案:<input type="file" name="file" /></p> <input type="submit" value="上傳" /> </form>
這種寫法最直接,但缺點也很明顯:提交會導致頁面刷新。很多時候我們不希望畫面被帶走,這時就要改用 AJAX。
$.ajax({
url: "",
type: "POST",
data: $('#uploadForm').serialize(),
success: function (data) { },
error: function (data) { }
});$('#uploadForm').serialize() 會把表單中所有欄位打包成 key=value&key2=value2 的查詢字串,一次送到後端,不必逐一取值。
但它有個明確的限制:檔案內容無法被序列化。序列化的結果只有 <input type="file"> 的欄位名稱,檔案本身的二進位內容會被丟掉。這是許多人卡住的地方。
如今主流瀏覽器都支援 FormData 物件,有了它就能輕鬆用 AJAX 上傳檔案。
<form id="uploadForm">
<p>上傳檔案:<input type="file" name="file" /></p>
<input type="button" value="上傳" onclick="upload()" />
</form>
<script>
function upload() {
// 直接把表單元素丟進建構子,它會自動收集所有欄位(含檔案)
var formData = new FormData($("#uploadForm")[0]);
$.ajax({
url: '',
type: 'POST',
data: formData,
async: false,
cache: false,
contentType: false, // 讓瀏覽器自行產生帶 boundary 的 Content-Type
processData: false, // 不要把資料轉成字串
success: function (data) { },
error: function (data) { }
});
}
</script>三個設定的作用值得逐一釐清:
processData: false 預設情況下 jQuery 會把 data 轉成查詢字串,這對 FormData 是災難性的。關掉它,資料才會原封不動送出。
contentType: false 若讓 jQuery 自行設定,它會寫上 application/x-www-form-urlencoded 卻沒有 boundary,後端無法切割出檔案。設為 false 之後,瀏覽器會自動補上正確的 multipart/form-data; boundary=...。
cache: false 避免上傳結果被快取,除錯時特別有用。
至於範例中的 async: false,除非有特殊的順序依賴需求,否則建議改回預設的異步——同步請求會讓整個瀏覽器分頁凍結直到回應回來,在現代前端開發中已不建議使用。
小結:純文字欄位用 serialize() 就夠;一旦涉及檔案,FormData 搭配 processData: false 與 contentType: false 是唯一正解。把這三者的關係記住,檔案上傳就不會再出問題。