HOWTO · JavaScript
如何在 JavaScript 中防止表單提交
使用 submit 事件監聽器、行內 onsubmit 處理常式或 jQuery,防止表單在用戶端驗證失敗時提交。
本頁內容
若要防止表單在其資料未通過用戶端驗證時提交,請處理表單的 submit 事件,並且僅在檢查失敗時呼叫 event.preventDefault()。將監聽器附加到表單,而不是其提交按鈕:表單的 submit 事件也涵蓋鍵盤提交。資料有效時,保持預設動作不變,讓瀏覽器可以提交表單。
使用 submit 事件監聽器防止表單提交
submit 監聽器是新 JavaScript 程式碼的常用選擇。這個獨立的 Node.js 範例模擬了瀏覽器表單所使用的事件介面,並展示有效的電子郵件如何到達正常提交路徑。在頁面中,使用 form.addEventListener('submit', handleSubmit) 註冊相同的處理常式。
const form = {
listener: null,
addEventListener(type, callback) {
if (type === 'submit') this.listener = callback;
},
submit(event) {
this.listener(event);
return !event.defaultPrevented;
}
};
const email = 'reader@example.com';
const handleSubmit = (event) => {
if (!email.includes('@')) event.preventDefault();
};
form.addEventListener('submit', handleSubmit);
const event = {
defaultPrevented: false,
preventDefault() {
this.defaultPrevented = true;
}
};
console.log(form.submit(event) ? 'Form may submit' : 'Submission prevented');
此範例的小型表單物件可讓處理常式在 Node.js 中執行;在瀏覽器中,瀏覽器會提供表單和事件。在您的頁面中,在處理常式內讀取相關控制項,並在檢查失敗時呼叫 event.preventDefault()。呼叫它會取消瀏覽器的預設提交動作;它不會導覽到其他頁面,也不會在記錄中後退。點擊提交按鈕和在表單控制項中按 Enter 都會導致表單的 submit 事件。
使用行內 onsubmit 處理常式
行內 onsubmit 處理常式是現有標記的替代方案。例如,<form onsubmit="return validateForm()"> 會在表單提交時呼叫函數。驗證失敗時傳回 false 以取消提交;表單準備好提交時傳回 true。讓該函數可供頁面使用,並確保它在每條路徑上都傳回值。對於新程式碼,監聽器通常可讓行為與 HTML 分離。
使用 jQuery 防止提交
如果專案已使用 jQuery,請使用 $('#myForm').on('submit', function (event) { ... }) 將處理常式附加到表單。在回呼內檢查表單值,並且僅在驗證失敗時呼叫 event.preventDefault()。不要從處理常式呼叫 $('#myForm').submit() 來防止提交:這會觸發提交行為,而不是取消瀏覽器的預設動作。jQuery 是可選的;原生的 addEventListener 無需相依性即可提供相同的表單事件。
驗證輸入並提供回饋
檢查失敗時,請防止提交,並在需要注意的欄位旁顯示簡潔的訊息。將該訊息與其控制項關聯,將錯誤公開給輔助技術,並在適當時將焦點移至第一個需要更正的欄位。避免僅依靠警告作為唯一的回饋。當所有檢查都通過時,允許提交繼續,並讓伺服器也驗證接收到的資料;用戶端檢查可改善互動,但本身並不能保護資料。
當符合表單需求時,可使用 required、type="email" 和 minlength 等 HTML 限制。瀏覽器可以在正常 submit 事件傳送之前報告這些失敗;自訂檢查可以新增 HTML 限制無法表達的規則。不要停用提交按鈕來代替驗證,因為使用者仍然需要明確的途徑來更正他們的輸入。