617 字
3 分鐘

CSS :user-invalid 怎麼用?表單互動後才顯示錯誤

本文目錄

空白的必填欄位從畫面載入起就符合 :invalid。如果只是想延後顯示紅框,保留 required 和其他 HTML 驗證條件,把錯誤樣式改掛在 :user-invalid。使用者嘗試送出不合法的表單時,原生驗證照樣會擋下。

先驗證送出和重設這兩條路徑#

把下面存成 HTML 後用瀏覽器開啟。範例只記錄成功觸發的 submit 事件,不發出網路請求。

<!doctype html>
<html lang="zh-Hant">
<meta charset="utf-8">
<title>延後顯示表單錯誤</title>
<style>
#email:user-invalid {
border: 2px solid #b42318;
}
#email:user-invalid + #email-hint {
color: #b42318;
font-weight: bold;
}
</style>
<form id="signup">
<label for="email">電子郵件(必填)</label>
<input id="email" name="email" type="email" required
aria-describedby="email-hint">
<small id="email-hint">請輸入電子郵件,例如 name@example.com。</small>
<button type="submit">送出</button>
<button type="reset">重設</button>
</form>
<output id="result"></output>
<script>
const form = document.querySelector('#signup');
const result = document.querySelector('#result');
form.addEventListener('submit', event => {
event.preventDefault();
result.textContent = '通過原生驗證';
});
form.addEventListener('reset', () => {
result.textContent = '';
});
</script>
</html>
  1. 剛開啟時,空欄位的 matches(':invalid') 為 true,matches(':user-invalid') 為 false,畫面沒有紅框。
  2. 空白時按送出,欄位出現錯誤樣式,頁底仍沒有「通過原生驗證」。
  3. 填入 name@example.com 後送出,錯誤樣式消失,頁底出現成功訊息。
  4. 按重設,欄位回到空白,兩個 selector 恢復為最初的匹配結果。

這四步比只在 DevTools 改 input.value 更接近操作現場。Selectors 規格允許瀏覽器依互動方式決定何時算有足夠的互動,因此不要把單純聚焦、離開欄位或程式寫值視為跨瀏覽器一致的觸發時機。Selectors Level 4 互動驗證狀態

需要固定時機或伺服器錯誤時,用明確狀態#

如果產品規格要求「只在按過送出之後顯示」或「按過送出後逐欄即時更新」,用表單自己的互動狀態控制時機。瀏覽器在驗證失敗時會觸發欄位的 invalid 事件,直接綁在表單可用 capture 監聽,但要注意 checkValidity() 也會觸發這個事件。若有程式化送出,先確認 requestSubmit 和 FormData 的送出路徑。

遇到「信箱已註冊」這類後端回傳的訊息,顯示明確文字並把它與欄位關聯。範例保留可讀的欄位提示和原生驗證回饋,紅框只是視覺提示。若目標瀏覽器不支援這個 selector,將樣式單獨放在一條規則中,讓表單仍可使用原生驗證。

參考資料:

CSS Selectors Level 4:The User-interaction Pseudo-classes

MDN:

WHATWG HTML:Constraint validation

CSS :user-invalid 怎麼用?表單互動後才顯示錯誤
https://laplusda.com/posts/css-user-invalid-form-feedback/
作者
Zero
發佈於
2026-11-20
許可協議
CC BY-NC-SA 4.0