表單包含 <input type="file"> 時,必須設置 enctype="multipart/form-data" 才能正確上傳文件。動態場景:
// 關鍵:同時設置 enctype 和 encoding(IE 兼容)
$('#myForm').attr({
'enctype': 'multipart/form-data', // 標準屬性
'encoding': 'multipart/form-data' // IE 專用別名
}).attr('method', 'POST') // 文件上傳必須 POST
.attr('action', '/upload'); // 上傳端點
// 如果在 iframe 中提交(老式無刷新上傳)
$('#myForm').attr('target', 'uploadIframe'); // 指定目標 iframe name
<form id="uploadForm" method="post" action="/api/upload">
<div class="form-group">
<label>文件描述:</label>
<input type="text" name="description" class="form-control">
</div>
<div class="form-group">
<label>選擇文件:</label>
<input type="file" name="file" id="fileInput" class="form-control">
</div>
<button type="submit" class="btn btn-primary">上傳</button>
<button type="button" id="switchMode" class="btn btn-secondary">切換為普通模式</button>
</form>
<!-- 隱藏 iframe 用於老式無刷新上傳 -->
<iframe name="uploadIframe" style="display:none;"></iframe>
<script>
$(function() {
const $form = $('#uploadForm');
const $fileInput = $('#fileInput');
const $switchBtn = $('#switchMode');
let isFileMode = true;
// 文件選擇時自動切換到 multipart
$fileInput.on('change', function() {
if (this.files.length > 0) {
enableFileUploadMode();
}
});
// 手動切換模式
$switchBtn.on('click', function() {
isFileMode = !isFileMode;
if (isFileMode) {
enableFileUploadMode();
$(this).text('切換為普通模式');
} else {
disableFileUploadMode();
$(this).text('切換為文件上傳模式');
}
});
function enableFileUploadMode() {
$form.attr({
'enctype': 'multipart/form-data',
'encoding': 'multipart/form-data', // 關鍵:IE 兼容
'method': 'POST',
'target': 'uploadIframe' // 可選:iframe 無刷新
});
$fileInput.show();
}
function disableFileUploadMode() {
$form.removeAttr('enctype encoding target')
.attr('method', 'POST'); // 恢復默認 application/x-www-form-urlencoded
$fileInput.hide();
}
// 現代 Fetch 上傳(推薦,無需 form enctype 折騰)
$('#modernUpload').on('click', async function() {
const formData = new FormData();
formData.append('file', $fileInput[0].files[0]);
formData.append('description', $form.find('[name="description"]').val());
try {
const res = await fetch('/api/upload', {
method: 'POST',
body: formData
// fetch 自動設置 multipart/form-data + boundary
});
const result = await res.json();
alert('上傳成功: ' + result.url);
} catch (err) {
console.error(err);
alert('上傳失敗');
}
});
});
</script>
| 值 | 用途 | Content-Type 標頭 |
|---|---|---|
application/x-www-form-urlencoded | 默認,普通表單 | key=value&key2=value2 (URL 編碼) |
multipart/form-data | **文件上傳** | multipart/form-data; boundary=----WebKitFormBoundary... |
text/plain | 極少用(調試) | 純文本,無編碼 |
enctype,只認 encoding 屬性enctype.attr():會同時設置 DOM 屬性和 property,雙寫無副作用現代項目若無 IE 支援要求,**可省略 encoding**。
// 完全繞過 form enctype 設置,瀏覽器自動構建 multipart 請求
async function uploadFile(file, metadata) {
const formData = new FormData();
formData.append('file', file);
Object.entries(metadata).forEach(([k, v]) => formData.append(k, v));
const response = await fetch('/api/upload', {
method: 'POST',
body: formData
// 不要手動設置 Content-Type!瀏覽器會自動生成含 boundary 的正確值
});
return response.json();
}
動態設置 enctype 的核心口訣:
「文件上傳必雙寫:
enctype標準、encoding兼容 IE;
method 必須 POST,action 指向上傳端點;
現代項目拋棄 form 提交,改用 FormData + Fetch。」
理解 multipart/form-data 的 boundary 分隔符機制、FormData 的自動構建能力,才是解決文件上傳問題的根本之道。