jQuery.Validate 是一款功能強大的表單驗證庫,本文全面整理它的預設規則、提示訊息、三種規則寫法與自訂樣式,是入門與查閱的實用參考。
下載 jquery.validate(本文以 1.9.0 版為例)後,常用的內建規則有:
(1) required:true 必輸字段 (2) remote:"check.php" 使用 ajax 調用 check.php 驗證輸入值 (3) email:true 必須輸入正確格式的電子郵件 (4) url:true 必須輸入正確格式的網址 (5) date:true 必須輸入正確格式的日期 (6) dateISO:true 必須輸入正確格式的日期(ISO),只驗證格式 (7) number:true 必須輸入合法數字(負數、小數) (8) digits:true 必須輸入整數 (9) creditcard: 必須輸入合法信用卡號 (10) equalTo:"#field" 輸入值必須和 #field 相同 (11) accept: 輸入擁有合法後綴名的字符串 (12) maxlength:5 長度最多 5 (13) minlength:10 長度最少 10 (14) rangelength:[5,10] 長度介於 5 到 10 之間 (15) range:[5,10] 值介於 5 到 10 之間 (16) max:5 值不能大於 5 (17) min:10 值不能小於 10
預設提示是英文,可存成 messages_cn.js 並在頁面引入,用 jQuery.extend 覆寫:
jQuery.extend(jQuery.validator.messages, {
required: "必選字段",
email: "請輸入正確格式的電子郵件",
url: "請輸入合法的網址",
// ...其餘規則同理,length 類可用 jQuery.validator.format 帶入參數...
});
寫法一:把規則寫到 control 的 class 中(需引入 jquery.metadata.js):
<input id="password" name="password" type="password" class="{required:true,minlength:5}" />
也可自訂提示:class="{required:true,minlength:5,messages:{required:'請輸入內容'}}"。注意使用 equalTo 時後面內容要加引號。
寫法二:使用 meta 關鍵字,初始化時傳 {meta: "validate"},class 寫成 {validate:{required:true, email:true}}。規則部分務必用完整形式,寫成 {validate:{required email}} 是錯誤的。
寫法三:把規則寫在 JS 代碼中(最推薦、最清晰):
$("#signupForm").validate({
rules:
{
firstname: "required",
email: { required: true, email: true },
password: { required: true, minlength: 5 },
confirm_password: { required: true, minlength: 5, equalTo: "#password" }
},
messages:
{
firstname: "請輸入姓名",
email: { required: "請輸入Email地址", email: "請輸入正確的email地址" },
password: { required: "請輸入密碼", minlength: jQuery.format("密碼不能小於{0}個字符") },
confirm_password: { required: "請輸入確認密碼", minlength: "確認密碼不能小於5個字符", equalTo: "兩次輸入密碼不一致" }
}
});
messages 處若某控制項沒有對應訊息,會自動採用預設值。
required 除了設為 true,還可用另外兩種形式實現「同時填或不填」的條件驗證:
required:"#aa:checked":當 id 為 aa 的 DOM 被選中時,才需要驗證該欄位。required:function(){ return true; }:回傳 true 時才驗證(僅對 required 有效)。例如當「打開」單選鈕被選中時,才要求填寫 email:
email: {
required: "#open:checked",
email: true
}
當 rules 規則單獨寫在 JS 中時,key 對應的是 input 的 name 屬性而非 id 屬性。這點要特別注意,否則規則會綁錯對象。
可透過 CSS 為錯誤狀態加上樣式:
/* jQuery.Validate css */
input.error{ border: 1px dotted red; }
label.error{
background-image:url('del.gif');
background-repeat:no-repeat;
padding-left:18px;
color: red;
}
其中 input.error 定義出錯輸入框的樣式,label.error 定義錯誤提示文字的樣式。效果圖如下:
