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 限制無法表達的規則。不要停用提交按鈕來代替驗證,因為使用者仍然需要明確的途徑來更正他們的輸入。