<form onsubmit="return handler()"> 中,handler 返回 false 可**阻止默認提交**;返回 true 或無返回值則繼續提交。這是表單攔截的最基礎語法。
<form id="regForm" onsubmit="return validateAndSubmit()">
<input name="username" required>
<input name="password" type="password" required>
<button type="submit">註冊</button>
</form>
<script>
function validateAndSubmit() {
var form = document.getElementById('regForm');
if (!form.checkValidity()) {
form.reportValidity(); // 顯示瀏覽器原生提示
return false; // 阻止提交
}
// 這裡可做額外同步檢查
return true; // 允許提交
}
</script>
<form id="regForm" novalidate> <!-- 關閉原生氣泡,自定義 UI -->
<div class="field">
<label for="username">用戶名</label>
<input type="text" id="username" name="username" required minlength="3" maxlength="16">
<span class="error" aria-live="polite"></span>
</div>
<button type="submit" class="btn-submit">提交</button>
</form>
<script>
var form = document.getElementById('regForm');
var submitBtn = form.querySelector('.btn-submit');
form.addEventListener('submit', function (e) {
e.preventDefault(); // 永遠阻止默認跳轉
// 1. 驗證
if (!form.checkValidity()) {
showErrors(form);
return;
}
// 2. 防重複提交
if (submitBtn.disabled) return;
submitBtn.disabled = true;
submitBtn.textContent = '提交中...';
// 3. 收集數據
var formData = new FormData(form);
// 4. AJAX 提交
fetch(form.action || '/api/register', {
method: form.method || 'POST',
body: formData,
credentials: 'same-origin' // 攜帶 Cookie
})
.then(function (res) {
if (!res.ok) throw new Error('HTTP ' + res.status);
return res.json();
})
.then(function (data) {
if (data.success) {
showToast('註冊成功,跳轉中...');
setTimeout(function () { location.href = data.redirect || '/'; }, 1500);
} else {
showFieldError(form.querySelector('[name="username"]'), data.message || '註冊失敗');
}
})
.catch(function (err) {
console.error(err);
showToast('網絡錯誤,請重試');
})
.finally(function () {
submitBtn.disabled = false;
submitBtn.textContent = '提交';
});
});
function showErrors(form) {
form.querySelectorAll(':invalid').forEach(function (el) {
var err = el.parentNode.querySelector('.error');
if (err) err.textContent = el.validationMessage;
el.style.borderColor = '#dc3545';
});
form.querySelector(':invalid').focus();
}
function showFieldError(el, msg) {
var err = el.parentNode.querySelector('.error');
if (err) err.textContent = msg;
el.style.borderColor = '#dc3545';
el.focus();
}
function showToast(msg) {
// 簡易 Toast 實現
var t = document.createElement('div');
t.textContent = msg;
t.style.cssText = 'position:fixed;bottom:20px;left:50%;transform:translateX(-50%);background:#333;color:#fff;padding:12px 24px;border-radius:4px;z-index:9999';
document.body.appendChild(t);
setTimeout(function () { t.remove(); }, 3000);
}
</script>
<button type="button" id="customSubmit">自定義提交按鈕</button>
<script>
document.getElementById('customSubmit').addEventListener('click', function () {
// 觸發表單驗證 + submit 事件,等同用戶點擊 type=submit
form.requestSubmit();
});
</script>
form.submit():後者**跳過驗證**、不觸發 submit 事件<form id="uploadForm" enctype="multipart/form-data">
<input type="file" name="avatar" accept="image/*" required>
<progress id="progress" value="0" max="100" hidden></progress>
<button type="submit">上傳</button>
</form>
<script>
document.getElementById('uploadForm').addEventListener('submit', function (e) {
e.preventDefault();
var formData = new FormData(this);
var xhr = new XMLHttpRequest(); // fetch 無法監聽上傳進度
xhr.upload.addEventListener('progress', function (e) {
if (e.lengthComputable) {
var percent = Math.round(e.loaded / e.total * 100);
document.getElementById('progress').value = percent;
document.getElementById('progress').hidden = false;
}
});
xhr.addEventListener('load', function () {
if (xhr.status >= 200 && xhr.status < 300) {
alert('上傳成功');
} else {
alert('上傳失敗: ' + xhr.status);
}
});
xhr.open('POST', this.action);
xhr.send(formData);
});
</script>
| 層級 | 方案 | 代碼關鍵點 |
|---|---|---|
| UI 層 | 按鈕 disabled + Loading 狀態 | btn.disabled = true |
| 邏輯層 | 標誌位鎖 | if (submitting) return; submitting = true; |
| 業務層 | 冪等性 Key(如訂單號) | 後端 SETNX order:123 lock |
| 網絡層 | 幂等請求頭 Idempotency-Key | Stripe/AWS 模式 |
表單提交攔截的核心是 **`e.preventDefault()` + 異步 `fetch`/`XMLHttpRequest`**。掌握 checkValidity()/reportValidity() 原生驗證、requestSubmit() 觸發標準流程、FormData 自動序列化、上傳進度監聽、多層防重機制,即可構建企業級表單交互體驗。