jQuery.validate 是一款強大的表單驗證插件。掌握它的一些常用配置與注意事項,能讓表單校驗變得高效而靈活。以下按主題逐一梳理。
$().ready(function() {
$("#signupForm").validate({
submitHandler: function(form){
alert("submitted");
form.submit();
}
});
});若想用 ajax 方式提交:
$(".selector").validate({
submitHandler: function(form){
$(form).ajaxSubmit();
}
});也可以通过 setDefaults 设置全局默認值。注意:要提交表單時,必須使用 form.submit() 而非 $(form).submit()。
把 debug 設為 true 後,表單只會進行檢查而不會真正提交,調試時十分方便,可用 $.validator.setDefaults 全局開啟。
例如 ignore: ".ignore",可讓指定元素跳過驗證。
errorPlacement 用於自定義錯誤提示的放置位置,默認是 error.appendTo(element.parent())。實際項目中常根據元素類型分別處理:
errorPlacement: function(error, element) {
if (element.is(":radio"))
error.appendTo(element.parent().next().next());
else if (element.is(":checkbox"))
error.appendTo(element.next());
else
error.appendTo(element.parent().next());
}此外還有 errorClass(錯誤提示的 CSS 類名)、errorElement(標記錯誤所用的標籤,默認 label)、errorContainer、errorLabelContainer、wrapper 等屬性,通常三者配合使用,可在統一容器內集中顯示所有錯誤並在無誤時自動隱藏。
input.error { border: 1px solid red; }
label.error {
background: url("./demo/images/unchecked.gif") no-repeat 0px 0px;
padding-left: 16px; padding-bottom: 2px;
font-weight: bold; color: #EA5200;
}
label.checked {
background: url("./demo/images/checked.gif") no-repeat 0px 0px;
}success: function(label) {
label.html(" ").addClass("checked");
}
//或
success: "valid"插件提供了 onsubmit、onfocusout、onkeyup、onclick、focusInvalid、focusCleanup 等布爾型開關,默認均為較友好的配置,除非有特殊需求,否則建議保持默認。重置表單可用 validator.resetForm()。
remote: {
url: "check-email.php", //後台處理程序
type: "post", //數據發送方式
dataType: "json", //接受數據格式
data: { username: function(){ return $("#username").val(); } }
}需要注意:遠程地址只能輸出 "true" 或 "false",不能有其他內容。
//中文字按兩個字節計算長度
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個字節)"));
//郵政編碼驗證
jQuery.validator.addMethod("isZipCode", function(value, element) {
var tel = /^[0-9]{6}$/;
return this.optional(element) || (tel.test(value));
}, "請正確填寫您的郵政編碼");自定義方法建議寫在 additional-methods.js 中,並在 messages 文件裡補充對應的提示文案,調用前別忘了引入該文件。
radio 的 required 表示必須選中一項;checkbox 的 required 表示必須勾選,minlength/maxlength/rangelength 可控制勾選數量區間;select 的 required 表示選中值不能為空,多選 select 同樣支持 minlength、maxlength、rangelength。這些規則都能通過 class 屬性直接聲明,非常直觀。