自己從零打造一個通用又完整的表單驗證外掛並不容易。jquery.validate 幾乎能應付九成五以上的驗證情境,值得花點時間把它的用法摸熟。
直接在 class 上寫規則名稱即可:
<input id="email" class="required email" value="email@" />
<input id="complex" value="hi" class="{required:true,minlength:3,maxlength:5,
messages:{required:'為什麼不輸入一點文字呢',minlength:'輸入的太少了',maxlength:'輸入那麼多幹嘛'}}" />
$().ready(function() {
$("#form2").validate({
rules: {
password: { required: true, minlength: 5 },
confirm_password: { required: true, minlength: 5, equalTo: "#password" }
},
messages: {
password: {
required: "沒有填寫密碼",
minlength: jQuery.format("密碼不能小於{0}個字符")
},
confirm_password: {
required: "沒有確認密碼",
minlength: "確認密碼不能小於{0}個字符",
equalTo: "兩次輸入密碼不一致嘛"
}
}
});
});
required 除了 true/false,也可以傳入運算式或函式,做出條件式必填:
$("#form2").validate({
rules: {
funcvalidate: {
required: function(){ return $("#password").val() != ""; }
}
},
messages: {
funcvalidate: { required: "有密碼的情況下必填" }
}
});
對應的 HTML:
密碼 <input id="password" name="password" type="password" /> 確認密碼 <input id="confirm_password" name="confirm_password" type="password" /> 條件驗證 <input id="funcvalidate" name="funcvalidate" value="" />
先告訴外掛要讀哪個 meta 名稱:
$("#form3").validate({ meta: "validate" });
HTML 中就能寫成:
<input class="{validate:{required:true,email:true,
messages:{required:'輸入 email 地址',email:'你輸入的不是有效的郵件地址'}}}" />
用 $.metadata.setType 指定要讀取的屬性名稱,就能把規則放在自己的標籤裡:
$().ready(function() {
$.metadata.setType("attr", "validate");
$("#form1").validate();
});
<input id="email" name="email"
validate="{required:true,email:true,
messages:{required:'輸入 email 地址',email:'你輸入的不是有效的郵件地址'}}" />
遇到內建規則應付不來的檢查,用 jQuery.validator.addMethod 擴充。官方提供的 additional-methods.js 收錄了 lettersOnly、zipRange、noWhitespace 等常用規則,可以直接參考。
jQuery.validator.addMethod("userName", function(value, element) {
return this.optional(element) || /^[\u0391-\uFFE5\w]+$/.test(value);
}, "用戶名只能包括中文字、英文字母、數字和下劃線");
$("#form1").validate({
rules: {
userName: { required: true, userName: true, rangelength: [5, 10] }
},
messages: {
userName: {
required: "請填寫用戶名",
rangelength: "用戶名必須在5-10個字符之間"
}
}
});
radio:
<span>
男 <input type="radio" id="gender_male" value="m" name="gender" class="{required:true}" /><br />
女 <input type="radio" id="gender_female" value="f" name="gender" />
</span>
checkbox(至少勾選兩項):
<span>
選項1 <input type="checkbox" id="check_1" value="1" name="checkGroup"
class="{required:true,minlength:2,messages:{required:'必須選擇',minlength:'至少選擇2項'}}" /><br />
選項2 <input type="checkbox" id="check_2" value="2" name="checkGroup" /><br />
選項3 <input type="checkbox" id="check_3" value="3" name="checkGroup" /><br />
</span>
select:
<span>
<select id="selectbox" name="selectbox" class="{required:true}">
<option value=""></option>
<option value="1">1</option>
<option value="2">2</option>
</select>
</span>
關鍵是同一組的 radio 或 checkbox 必須共用相同的 name,外掛才會把它們視為一體來驗證。
remote: {
url: "url",
type: "post",
dataType: "json",
data: {
username: function(){ return $("#username").val(); }
}
}
實務上這幾個規則幾乎每個專案都會用到,可以整理成一個共用腳本:
// 手機號碼
jQuery.validator.addMethod("mobile", function(value, element) {
var mobile = /^(((13[0-9]{1})|(15[0-9]{1}))+\d{8})$/;
return this.optional(element) || (value.length == 11 && mobile.test(value));
}, "手機號碼格式錯誤");
// 電話號碼
jQuery.validator.addMethod("phone", function(value, element) {
var tel = /^(0[0-9]{2,3}\-)?([2-9][0-9]{6,7})+(\-[0-9]{1,4})?$/;
return this.optional(element) || tel.test(value);
}, "電話號碼格式錯誤");
// 郵遞區號
jQuery.validator.addMethod("zipCode", function(value, element) {
return this.optional(element) || /^[0-9]{6}$/.test(value);
}, "郵遞區號格式錯誤");
// QQ 號
jQuery.validator.addMethod("qq", function(value, element) {
return this.optional(element) || /^[1-9]\d{4,9}$/.test(value);
}, "QQ 號碼格式錯誤");
// IP 位址
jQuery.validator.addMethod("ip", function(value, element) {
var ip = /^((?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
return this.optional(element) || ip.test(value);
}, "IP 位址格式錯誤");
// 英數字
jQuery.validator.addMethod("chrnum", function(value, element) {
return this.optional(element) || /^([a-zA-Z0-9]+)$/.test(value);
}, "只能輸入數字和字母");
// 中文
jQuery.validator.addMethod("chinese", function(value, element) {
return this.optional(element) || /^[\u4e00-\u9fa5]+$/.test(value);
}, "只能輸入中文");
// 下拉選單不可停在提示項
$.validator.addMethod("selectNone", function(value, element) {
return value != "請選擇";
}, "必須選擇一項");
// 位元組長度(中文算 2 個位元組)
jQuery.validator.addMethod("byteRangeLength", function(value, element, param) {
var length = value.length;
for (var i = 0; i < value.length; i++) {
if (value.charCodeAt(i) > 127) { length++; }
}
return this.optional(element) || (length >= param[0] && length <= param[1]);
}, $.validator.format("請確保輸入的值在{0}-{1}個位元組之間(一個中文字算2個位元組)"));
這個外掛最實用的設計是「規則與訊息分離」:規則負責判斷,訊息負責說明,兩邊各自獨立設定,畫面文案一改不必動到驗證邏輯。另外記得,前端驗證只是使用者體驗的優化,伺服器端一定要再驗證一次。