現代 Web 開發中,表單提交主要有三種模式,各有優缺點與適用場景。
<form action="/api/login" method="POST">
<input type="email" name="email" required>
<input type="password" name="password" required>
<button type="submit">登入</button>
</form>
// 原生 XMLHttpRequest (支援進度、中止、超時)
function submitForm(formEl, onSuccess, onError) {
const formData = new FormData(formEl); // 自動收集所有欄位 (含檔案)
const xhr = new XMLHttpRequest();
xhr.open('POST', formEl.action);
xhr.onload = () => {
if (xhr.status >= 200 && xhr.status < 300) onSuccess(xhr.response);
else onError(xhr.status, xhr.response);
};
xhr.onerror = () => onError(0, 'Network error');
xhr.send(formData);
}
// jQuery 簡寫
$('#my-form').on('submit', function(e) {
e.preventDefault();
$.ajax({
url: this.action,
type: this.method,
data: new FormData(this),
processData: false, // 必須 false,否則 jQuery 會嘗試序列化 FormData
contentType: false, // 必須 false,讓瀏覽器自動設定 multipart boundary
success: res => console.log('成功', res),
error: (xhr, status, err) => console.error('失敗', status, err)
});
});
async function submitFormFetch(formEl) {
const formData = new FormData(formEl);
try {
const response = await fetch(formEl.action, {
method: formEl.method,
body: formData,
credentials: 'same-origin', // 攜帶 Cookie
// headers: {'X-CSRF-Token': getCsrfToken()} // 若需 CSRF Token 手動加入
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const result = await response.json(); // 或 .text(), .blob()
return result;
} catch (err) {
console.error('提交失敗', err);
throw err;
}
}
// 使用
document.getElementById('my-form').addEventListener('submit', async e => {
e.preventDefault();
const btn = e.target.querySelector('button[type="submit"]');
btn.disabled = true; btn.textContent = '處理中...';
try {
await submitFormFetch(e.target);
alert('成功!');
// 跳轉或更新 UI
} catch (err) {
alert('失敗: ' + err.message);
} finally {
btn.disabled = false; btn.textContent = '送出';
}
});
const form = document.getElementById('my-form');
const fd = new FormData(form); // 自動收集所有 name 屬性的欄位
// 手動操作
fd.append('extra_field', 'value'); // 新增
fd.append('files[]', fileInput.files[0]); // 新增檔案 (多檔同名加 [])
fd.set('email', 'new@example.com'); // 覆蓋 (單值)
fd.delete('unwanted'); // 移除
fd.has('email'); fd.get('email'); fd.getAll('files[]'); // 查詢
// 迭代
for (const [key, value] of fd.entries()) {
console.log(key, value instanceof File ? `File: ${value.name}` : value);
}
// 轉 JSON (僅非檔案欄位)
const json = {};
for (const [k, v] of fd) if (!(v instanceof File)) json[k] = v;
const form = document.getElementById('my-form');
form.addEventListener('submit', async e => {
e.preventDefault(); // 先阻止原生提交
// 1. 觸發瀏覽器原生驗證 UI
if (!form.checkValidity()) {
form.reportValidity(); // 顯示氣泡、聚焦第一個無效欄位
return;
}
// 2. 自訂業務驗證 (如密碼強度、確認密碼)
const pwd = form.password.value;
const confirm = form.confirm_password.value;
if (pwd !== confirm) {
form.confirm_password.setCustomValidity('兩次密碼不一致');
form.reportValidity();
return;
}
form.confirm_password.setCustomValidity(''); // 清除
// 3. 實際提交 (Fetch)
try {
await submitFormFetch(form);
// 成功處理...
} catch (err) {
// 失敗處理...
}
});
// 即時驗證回饋 (可選)
form.querySelectorAll('input, select, textarea').forEach(el => {
el.addEventListener('blur', () => {
if (!el.validity.valid) el.reportValidity();
else el.setCustomValidity('');
});
el.addEventListener('input', () => el.setCustomValidity('')); // 輸入時清除自訂錯誤
});
<form id="upload-form" action="/api/upload" method="POST">
<div id="drop-zone" class="drop-zone">
拖拽檔案到這裡或 <input type="file" id="file-input" name="files[]" multiple>
</div>
<div id="file-list"></div>
<progress id="overall-progress" value="0" max="100" hidden></progress>
<button type="submit">開始上傳</button>
</form>
<script>
const dropZone = document.getElementById('drop-zone');
const fileInput = document.getElementById('file-input');
const fileList = document.getElementById('file-list');
const filesMap = new Map(); // fileId -> {file, xhr, progressEl}
['dragenter','dragover','dragleave','drop'].forEach(evt =>
dropZone.addEventListener(evt, e => { e.preventDefault(); e.stopPropagation(); })
);
dropZone.addEventListener('drop', e => {
handleFiles(Array.from(e.dataTransfer.files));
});
fileInput.addEventListener('change', e => handleFiles(Array.from(e.target.files)));
function handleFiles(files) {
files.filter(f => f.type.startsWith('image/') || f.type.startsWith('video/') || f.type === 'application/pdf')
.forEach(file => {
const id = 'f_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
const div = document.createElement('div');
div.className = 'file-item';
div.innerHTML = `
<img src="${URL.createObjectURL(file)}" class="preview">
<span class="name">${escapeHtml(file.name)}</span>
<progress class="progress" value="0" max="100"></progress>
<button type="button" class="remove">移除</button>
`;
fileList.appendChild(div);
filesMap.set(id, {file, div, progressEl: div.querySelector('.progress')});
div.querySelector('.remove').onclick = () => { filesMap.delete(id); div.remove(); };
});
}
document.getElementById('upload-form').addEventListener('submit', async e => {
e.preventDefault();
if (filesMap.size === 0) return alert('請先選擇檔案');
const overallProgress = document.getElementById('overall-progress');
overallProgress.hidden = false; overallProgress.value = 0;
let completed = 0;
for (const [id, {file, progressEl}] of filesMap) {
const fd = new FormData();
fd.append('file', file);
await new Promise((resolve, reject) => {
const xhr = new XMLHttpRequest(); // 僅 XHR 支援 upload 進度事件
xhr.open('POST', '/api/upload');
xhr.upload.onprogress = e => {
if (e.lengthComputable) progressEl.value = (e.loaded / e.total) * 100;
};
xhr.onload = () => xhr.status >= 200 && xhr.status < 300 ? resolve() : reject(xhr.statusText);
xhr.onerror = () => reject('Network error');
xhr.send(fd);
});
completed++;
overallProgress.value = (completed / filesMap.size) * 100;
}
alert('全部上傳完成!');
filesMap.clear(); fileList.innerHTML = ''; overallProgress.hidden = true;
});
</script>
const multer = require('multer');
const upload = multer({
storage: multer.diskStorage({
destination: (req, file, cb) => cb(null, 'uploads/'),
filename: (req, file, cb) => cb(null, Date.now() + '_' + file.originalname)
}),
limits: { fileSize: 50 * 1024 * 1024 }, // 50MB
fileFilter: (req, file, cb) => {
const allowed = ['image/jpeg', 'image/png', 'video/mp4', 'application/pdf'];
cb(null, allowed.includes(file.mimetype));
}
});
app.post('/api/upload', upload.array('files'), (req, res) => {
// req.files 陣列包含上傳檔案資訊
res.json({success: true, files: req.files.map(f => ({name: f.originalname, path: f.path}))});
});
HTML5 表單提交已從單純的同步重載演進為靈活的 **Fetch + FormData** 非同步模式,配合 **原生驗證 API**、**進度事件**、**拖拽 API**,能構建極佳使用者體驗的上傳/提交介面。核心原則:**漸進式增強** (基礎功能無 JS 可用)、**前後端雙重驗證**、**安全防護 (CSRF、檔案型別、權限)**、**錯誤處理與使用者回饋**。