jquery.validate使用攻略
时间：2023-07-31 09:07:24
转自http://200318077.iteye.com/blog/806701
主要分几部分
jquery.validate 基本用法
jquery.validate API说明
jquery.validate 自定义
jquery.validate 常见类型的验证代码
下载地址
jquery.validate插件的文件地址
http://docs.jquery.com/Plugins/Validation
jquery.validate插件的主页
http://bassistance.de/jquery-plugins/jquery-plugin-validation/
jquery.validate主页上提供的插件demo
http://jquery.bassistance.de/validate/demo/
验证规则
以下是默认验证规则，规则也可以自定义 (1)required:true 必输字段 (2)remote:"check.php" 使用ajax方法调用check.php验证输入值 (3)email:true 必须输入正确格式的电子邮件 (4)url:true 必须输入正确格式的网址 (5)date:true 必须输入正确格式的日期 (6)dateISO:true 必须输入正确格式的日期(ISO)，例如：2009-06-23，1998/01/22 只验证格式，不验证有效性 (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 验证提示 以下是默认验证提示。官网有简体中文版的验证提示下载或通过jQuery.extend(jQuery.validator.messages自定义错误提示信息可以将网站验证提示文本统一到文件中。 required: "This field is required.", remote: "Please fix this field.", email: "Please enter a valid email address.", url: "Please enter a valid URL.", date: "Please enter a valid date.", dateISO: "Please enter a valid date (ISO).", number: "Please enter a valid number.", digits: "Please enter only digits", creditcard: "Please enter a valid credit card number.", equalTo: "Please enter the same value again.", accept: "Please enter a value with a valid extension.", maxlength: $.validator.format("Please enter no more than {0} characters."), minlength: $.validator.format("Please enter at least {0} characters."), rangelength: $.validator.format("Please enter a value between {0} and {1} characters long."), range: $.validator.format("Please enter a value between {0} and {1}."), max: $.validator.format("Please enter a value less than or equal to {0}."), min: $.validator.format("Please enter a value greater than or equal to {0}.") 使用方式 1： 默认验证规则用于控件： 电子邮件(必填)
2： 例如： 自定义(必填，[3，5]) 3: 通过javascript自定义验证规则，以下是JS两条规则自定义，password和confirm_password $().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 密码 确认密码 条件验证 4： 使用meta定制验证信息 首先用JS设置meta $("#form3").validate({ meta: "validate" }); Html email 5: 使用meta验证规则可以写在自定义标签中，比如validate JS设置meta $().ready(function() { $.metadata.setType("attr", "validate"); $("#form1").validate(); }); Html Email 6: 自定义验证规则 对复杂的验证，可以通过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: { equired: true,
userName: true,
rangelength: [5,10]
}
},
/* 设置错误信息 */
messages: {
userName: {
required: "请填写用户名",
rangelength: "用户名必须在5-10个字符之间"
}
},
});
7:
radio、checkbox、select的验证方式类似
radio的验证
性别
男
女
checkbox的验证
最少选择两项
选项1
选项2
选项3
select的验证
下拉框
8:
Ajax验证
用remote可以进行Ajax验证
remote: {
url: "url", //url地址
type: "post", //发送方式
dataType: "json", //数据格式 data: { //要传递的数据
username: function() {
return $("#username").val();
}}
}
Plugin methods
Name Type validate( options ) Returns: Validator 验证所选的FORM valid( ) Returns: Boolean 检查是否验证通过 rules( ) Returns: Options 返回元素的验证规则 rules( "add", rules ) Returns: Options 增加验证规则 rules( "remove", rules ) Returns: Options 删除验证规则 removeAttrs( attributes ) Returns: Options 删除特殊属性并且返回他们 Custom selectors Name Type :blank Returns: Array没有值的筛选器 :filled Returns: Array 有值的筛选器 :unchecked Returns: Array 没选择的元素的筛选器 Utilities Name Type jQuery.format( template, argument , argumentN... ) Returns: String 用参数代替模板中的 {n}。 Validator
validate方法返回一个Validator对象, 它有很多方法， 让你能使用引发校验程序或者改变form的内容. 下面只是列出常用的. form( ) Returns: Boolean 验证form返回成功还是失败 element( element ) Returns: Boolean 验证单个元素是成功还是失败 resetForm( ) Returns: undefined 把前面验证的FORM恢复到验证前原来的状态 showErrors( errors ) Returns: undefined 显示特定的错误信息 built-in Validation methods Name Type setDefaults( defaults ) Returns: undefined 改变默认的设置 addMethod( name, method, message ) Returns: undefined 添加一个新的验证方法. 必须包括名字，一个JAVASCRIPT方法和一个默认的信息 addClassRules( name, rules ) Returns: undefined 增加组合验证类型 addClassRules( rules ) Returns: undefined 增加组合验证类型 built-in Validation methods
Name Type required( ) Returns: Boolean 必填验证元素 required( dependency-expression ) Returns: Boolean 必填元素依赖于表达式的结果. required( dependency-callback ) Returns: Boolean 必填元素依赖于回调函数的结果. remote( url ) Returns: Boolean 请求远程校验。url通常是一个远程调用方法 minlength( length ) Returns: Boolean 设置最小长度 maxlength( length ) Returns: Boolean 设置最大长度 rangelength( range ) Returns: Boolean 设置一个长度范围[min,max] min( value ) Returns: Boolean 设置最小值. max( value ) Returns: Boolean 设置最大值. range( range ) Returns: Boolean 设置值的范围 email( ) Returns: Boolean 验证电子邮箱格式 url( ) Returns: Boolean 验证连接格式 date( ) Returns: Boolean 验证日期格式(类似30/30/2008的格式，不验证日期准确性只验证格式) dateISO( ) Returns: Boolean 研制ISO类型的日期格式 dateDE( ) Returns: Boolean 验证德式的日期格式（29.04.1994 or 1.1.2006） number( ) Returns: Boolean 验证十进制数字（包括小数的） numberDE( ) Returns: Boolean Makes the element require a decimal number with german format. digits( ) Returns: Boolean 验证整数 creditcard( ) Returns: Boolean 验证信用卡号 accept( extension ) Returns: Boolean 验证相同后缀名的字符串 equalTo( other ) Returns: Boolean 验证两个输入框的内容是否相同
自定义jquery-validate的验证行为
1: 自定义表单提交
设置submitHandler来自定义表单提交动作
$(".selector").validate({
submitHandler: function(form) { alert("验证通过"); }
});
如果需要提交表单，可以调用
form.submit(); 或者$(form).ajaxSubmit();
2: 调试模式
将debug设置为true，表单不会提交，只进行检查，方便调试
$(".selector").validate({
debug: true
})
3: 设置validate的默认值
使用setDefaults可以设置validate的默认值，比如默认所有表单验证都是在debug模式下进行
$.validator.setDefaults({
debug: true
})
4: 某些元素不验证
设置ignore属性可以忽略某些元素不验证
$(".selector").validate({
ignore: "ignore"
})
5: 验证时机
jquery.validate可以很方便的设置在什么时候触发验证动作
onsubmit: 提交时是否验证
$(".selector").validate({
onsubmit: false
})
onfocusout: 失去焦点时验证(checkboxes/radio除外)
$(".selector").validate({
onfocusout: false
})
onkeyup: 在keyup时验证
$(".selector").validate({
onkeyup: false
})
onclick: 在checkboxes、radio点击时验证.
$(".selector").validate({
onclick: false
})
6: 重写验证规则和验证提示信息
//重写max的的验证提示信息
$.validator.messages.max = jQuery.format("Your totals musn't exceed {0}!");
//重写equal方法
$.validator.methods.equal = function(value, element, param) {
return value == param;
};
7: focusInvalid 是否把焦点聚焦在最后一个动作或者最近的一次出错上
$(".selector").validate({
focusInvalid: false
})
8: focusCleanup
如果该属性设置为True, 那么控件获得焦点时，移除出错的class定义，隐藏错误信息，避免和 focusInvalid.一起用。
$(".selector").validate({
focusCleanup: true
})
9: meta
设置meta来封装验证规则
$(".selector").validate({
meta: "validate",
})
自定义错误消息的显示方式
默认情况下，验证提示信息用label元素来显示, 并且会添加css class, 通过css可以很方便设置出错控件以及错误信息的显示方式。
/* 输入控件验证出错*/
form input.error { border:solid 1px red;}
/* 验证错误提示信息*/
form label.error{width: 200px;margin-left: 10px; color: Red;}
如果想自定义显示方式，可以修改jquery.validate的默认显示方式
默认用label显示错误消息，可以通过errorElement属性来修改
errorElement: 错误消息的html标签
$(".selector").validate
errorElement: "em"
})
可以在出错信息外用其他的元素包装一层。
wrapper: 错误消息的外层封装html标签
$(".selector").validate({
wrapper: "li"
})
验证出错的css class默认是error，通过errorClass可以修改
errorClass: 验证出错时使用的css class
$(".selector").validate({
errorClass: "invalid"
})
还自定义验证成功时的动作
success: 如果值是字符串，会当做一个css类，如果是一个函数，则执行该函数
$(".selector").validate({
success: "valid"
})
或者
success: function(label) {
label.html(" ").addClass("checked");
}
还可以把错误消息统一到一个容器显示
errorLabelContainer: 将错误消息统一到一个容器显示
$("#myform").validate({
errorLabelContainer: "#messageBox"
})
默认情况下，错误消息是放在验证元素后面的，可以自定义错误消息的显示位置
$(".selector").validate({
errorPlacement: function(error, element) {
error.appendTo( element.parent("td").next("td") );
}
})
更进一步可以定义一个组，把几个地方的出错信息统一放在一个地方，用error Placement控制把出错信息放在哪里
groups：定义一个组
$(".selector").validate({
groups: {
username: "fname lname"
},
errorPlacement: function(error, element) {
if (element.attr("name") == "fname" || element.attr("name") == "lname" )
error.insertAfter("#lastname");
else
error.insertAfter(element);
}
})
高亮显示
highlight: 高亮显示，默认是添加errorClass
unhighlight: 和highlight对应，反高亮显示
$(".selector").validate({
highlight: function(element, errorClass) {
$(element).addClass(errorClass);
$(element.form).find("label[for=" + element.id + "]").addClass(errorClass);
},
unhighlight: function(element, errorClass) {
$(element).removeClass(errorClass);
$(element.form).find("label[for=" + element.id + "]").removeClass(errorClass);
}
});
或者可以完全自定义错误显示
showErrors: 得到错误的显示句柄
$(".selector").validate({
showErrors: function(errorMap, errorList) {
$("#summary").html("Your form contains " + this.numberOfInvalids()
+ " errors, see details below.");
this.defaultShowErrors();
}
})
// 手机号码验证 jQuery.validator.addMethod("mobile", function(value, element) { var length = value.length; var mobile = /^(((13[0-9]{1})|(15[0-9]{1}))+\d{8})$/ return this.optional(element) || (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) { var tel = /^[0-9]{6}$/; return this.optional(element) || (tel.test(value)); }, "邮政编码格式错误"); // QQ号码验证 jQuery.validator.addMethod("qq", function(value, element) { var tel = /^[1-9]\d{4,9}$/; return this.optional(element) || (tel.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) && (RegExp.$1 < 256 && RegExp.$2 < 256 && RegExp.$3 < 256 && RegExp.$4 < 256)); }, "Ip地址格式错误"); // 字母和数字的验证 jQuery.validator.addMethod("chrnum", function(value, element) { var chrnum = /^([a-zA-Z0-9]+)$/; return this.optional(element) || (chrnum.test(value)); }, "只能输入数字和字母(字符A-Z, a-z, 0-9)"); // 中文的验证 jQuery.validator.addMethod("chinese", function(value, element) { var chinese = /^[\u4e00-\u9fa5]+$/; return this.optional(element) || (chinese.test(value)); }, "只能输入中文"); // 下拉框验证 $.validator.addMethod("selectNone", function(value, element) { return value == "请选择"; }, "必须选择一项"); // 字节长度验证 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个字节)"));
