HTML5 的表單驗證給前端帶來不少便利,但使用者體驗上存在缺陷:瀏覽器預設的提示訊息對使用者並不友善,也無法準確傳達我們想說的資訊。好消息是規格提供了 setCustomValidity() 方法,能自訂提示內容;壞消息是它需要開發者額外做一些處理,才能真正達到想要的效果。
<!DOCTYPE HTML>
<head>
<meta charset="UTF-8">
<title>使用 JavaScript 驗證表單輸入</title>
<script>
function check() {
var pass1 = document.getElementById("pass1");
var pass2 = document.getElementById("pass2");
if (pass1.value != pass2.value) {
pass2.setCustomValidity("兩次輸入的密碼不一致");
} else {
pass2.setCustomValidity("");
}
var email = document.getElementById("email");
if (!email.checkValidity()) {
email.setCustomValidity("請輸入正確的 email 位址");
} else {
email.setCustomValidity("");
}
}
</script>
</head>
<body>
<form id="testForm" onsubmit="return check()">
密碼:<input type="password" name="pass1" id="pass1" /><br/>
確認密碼:<input type="password" name="pass2" id="pass2" /><br/>
Email:<input type="email" name="email" id="email" /><br/>
<input type="submit" />
</form>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>form test</title>
</head>
<body>
<form name="test" action="." method="post">
<input type="text" required pattern="^\d{4}$" oninput="out(this)" placeholder="請輸入代碼" >
<button type="submit">Check</button>
</form>
<script>
function out(i) {
var v = i.validity;
if (v.valueMissing) {
i.setCustomValidity("請填寫這個欄位");
} else if (v.patternMismatch) {
i.setCustomValidity("請輸入 4 位數字的代碼");
} else {
i.setCustomValidity("");
}
}
</script>
</body>
</html>
一定要記得清空自訂訊息。setCustomValidity 設定後的訊息會「黏」在元素上,直到再次設為空字串為止。也就是說,使用者修正輸入後,若沒有在 oninput 或 onchange 中呼叫 setCustomValidity(""),表單會永遠無法送出。這是這個 API 最常見的誤用。
善用 validity 的細項狀態。不要自己寫一堆正則去重判,瀏覽器已經幫你算好了:valueMissing(必填未填)、typeMismatch(型別不符)、patternMismatch(不符合 pattern)、tooLong、rangeUnderflow、rangeOverflow、stepMismatch、badInput。依這些旗標分支給出對應訊息,程式碼會比手写驗證乾淨得多。
另外要注意,示例一的 onsubmit="return check()" 寫法有個缺陷:函式沒有回傳值,等於永遠回傳 undefined,反而可能讓表單照樣送出。正確做法是在驗證失敗時明確 return false,或改用 event.preventDefault()。而原範例中的 getElementbyid 大小寫有誤(正確是 getElementById),這類拼寫錯誤在複製範例程式碼時特別容易發生,值得留意。