主要分几部分
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" }); Htmlemail5:使用meta可以将验证规则写在自定义的标签内,比如validateJS设置meta$().ready(function() { $.metadata.setType("attr", "validate"); $("#form1").validate();});HtmlEmail6:自定义验证规则对于复杂的验证,可以通过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个字符之间" } },}); 7:radio、checkbox、select的验证方式类似radio的验证 性别 男 女 checkbox的验证最少选择两项 选项1 选项2 选项3select的验证下拉框 8:Ajax验证用remote可以进行Ajax验证remote: {url: "url", //url地址type: "post", //发送方式dataType: "json", //数据格式 data: { //要传递的数据 username: function() { return $("#username").val(); }}} Plugin methods
Name Typevalidate( options ) Returns: Validator验证所选的FORMvalid( ) 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 TypejQuery.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 TypesetDefaults( defaults ) Returns: undefined改变默认的设置addMethod( name, method, message ) Returns: undefined添加一个新的验证方法. 必须包括名字,一个JAVASCRIPT方法和一个默认的信息addClassRules( name, rules ) Returns: undefined增加组合验证类型 addClassRules( rules ) Returns: undefined增加组合验证类型 built-in Validation methods
Name Typerequired( ) 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: BooleanMakes 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",})
<script type="text/javascript"></script>
自定义错误消息的显示方式默认情况下,验证提示信息用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: 高亮显示,默认是添加errorClassunhighlight: 和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(); }})
<script type="text/javascript"></script> // 手机号码验证 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个字节)"));