DIV CSS 佈局教程網

HTML5 + setCustomValidity() 自訂表單驗證提示實例
編輯:關於JavaScript     

HTML5 的表單驗證給前端帶來不少便利,但使用者體驗上存在缺陷:瀏覽器預設的提示訊息對使用者並不友善,也無法準確傳達我們想說的資訊。好消息是規格提供了 setCustomValidity() 方法,能自訂提示內容;壞消息是它需要開發者額外做一些處理,才能真正達到想要的效果。

示例一:密碼確認與 Email 驗證

<!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>

示例二:用 validity 狀態決定提示內容

<!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),這類拼寫錯誤在複製範例程式碼時特別容易發生,值得留意。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved