jQuery验证框架(六)内置验证方法 (jQuery validation)
jQuery验证框架
六、框架内建的验证方法( List of built-in Validation methods )
[1]? required( ) ????? 返回:Boolean
????? 说明:让表单元素必须填写(选择)。
????????????????? 如果表单元素为空(text input)或未选择(radio/checkbox)或选择了一个空值(select)。
????????????????? 作用于text inputs, selects, checkboxes and radio buttons.
????????????????? 当select提供了一个空值选项<option value="">Choose...</option>则强迫用户去选择一个不为空的值。
- $("#myform").validate({ rules: { fruit: "required" }});
[2]? required( dependency-expression ) ????? 返回:Boolean
????? 参数 dependency-expression???? 类型:String??? 在form上下文中的一个表达式( String ),表单元素是否需要填写依赖于该表达式返回一个或多个元素。
????? 说明:让表单元素必须填写(选择),依赖于参数的返回值。
????????????????? 表达式中像#foo:checked, #foo:filled, #foo:visible这样的选择过滤器将经常用到。
- $("#myform").validate({ rules: { details: { required: "#other:checked" } }, debug:true});$("#other").click(function() { $("#details").valid();});
[3]? required( dependency-callback ) ????? 返回:Boolean
????? 参数 dependency-callback???? 类型:Callback?? 该回函数以待验证表单元素作为其唯一的参数。当该回调函数返回true,则该表单元素是必须的。
????? 说明:让表单元素必须填写(选择),依赖于参数的返回值。
????????????????? 表达式中像#foo:checked, #foo:filled, #foo:visible这样的选择过滤器将经常用到。
- $("#myform").validate({ rules: { age: { required: true, min: 3 }, parent: { required: function(element) { return $("#age").val() < 13; } } }});$("#age").blur(function() { $("#parent").valid();});
[4]? remote( options ) ????? 返回:Boolean
????? 参数 options ???? 类型:String, Options??? 请求服务器端资源的url(String)。或$.ajax()方法中的选项(Options)。
????? 说明:请求服务器端资源验证。
????????????????? 服务器端的资源通过$.ajax (XMLHttpRequest)获取key/value对,响应返回true则表单通过验证。
- $("#myform").validate({ rules: { email: { required: true, email: true, remote: "check-email.php" } }});
[5]? minlength( length ) ????? 返回:Boolean
????? 参数 length ???? 类型:Integer??? 至少需要多少个字符数。
????? 说明:确保表单元素满足给定的最小字符数。
????????????????? 在文本框(text input)中输入的字符太少、没有选中足够的复选框(checkbox)、一个选择框(select)中没有选中足够的选项。这以上三种情况中该方法返回false。
- $("#myform").validate({ rules: { field: { required: true, minlength: 3 } }});
[6]? maxlength( length ) ????? 返回:Boolean
????? 参数 length ???? 类型:Integer??? 允许输入的最大字符数。
????? 说明:确保表单元素的文本不超过给定的最大字符数。
????????????????? 在文本框(text input)中输入的字符太多、选择太多的复选框(checkbox)、一个选择框(select)中没有选中太多的选项。这以上三种情况中该方法返回false。
- $("#myform").validate({ rules: { field: { required: true, maxlength: 4 } }});
[7]? rangelength( range ) ????? 返回:Boolean
????? 参数 range ???? 类型:Array<Integer>??? 允许输入的字符数范围。
????? 说明:确保表单元素的文本字符数在给定的范围当中。
????????????????? 在文本框(text input)中输入的字符数不在给定范围内、选择的复选框(checkbox)不在给在的范围内、一个选择框(select)选中的选项不在给定的范围内。这以上三种情况中该方法返回false。
- $("#myform").validate({ rules: { field: { required: true, rangelength: [2, 6] } }});
[8]? min( value ) ????? 返回:Boolean
????? 参数 value ???? 类型:Integer??? 需要输入的最小整数。
????? 说明:确保表单元素的值大于等于给定的最小整数。
????????????????? 该方法只在文本输入框(text input)下有效。
- $("#myform").validate({ rules: { field: { required: true, min: 13 } }});
[9]? max( value ) ????? 返回:Boolean
????? 参数 value ???? 类型:Integer??? 给定的最大整数。
????? 说明:确保表单元素的值小于等于给定的最大整数。
????????????????? 该方法只在文本输入框(text input)下有效。
- $("#myform").validate({ rules: { field: { required: true, max: 23 } }});
[10]? range( range ) ????? 返回:Boolean
????? 参数 range???? 类型:Array<Integer>??? 给定的整数范围。
????? 说明:确保表单元素的值在给定的范围当中。
????????????????? 该方法只在文本输入框(text input)下有效。
- $("#myform").validate({ rules: { field: { required: true, range: [13, 23] } }});
[11]? email( ) ????? 返回:Boolean
????? 说明:确保表单元素的值为一个有效的email地址。
????????????????? 如果值为一个有效的email地址,则返回true。该方法只在文本输入框(text input)下有效。
- $("#myform").validate({ rules: { field: { required: true, email: true } }});
[12]? url( ) ????? 返回:Boolean
????? 说明:确保表单元素的值为一个有效的URL地址(http://www.mydomain.com)。
????????????????? 如果值为一个有效的url地址,则返回true。该方法只在文本输入框(text input)下有效。
- $("#myform").validate({ rules: { field: { required: true, url: true } }});
[13]? date( )? dateISO( )? dateDE( )????? 返回:Boolean
????? 说明:用来验证有效的日期。这三个函数分别验证的日期格式为(mm/dd/yyyy)、(yyyy-mm-dd,yyyy/mm/dd)、(mm.dd.yyyy)。
- $("#myform").validate({ rules: { field: { required: true, date: true /*dateISO: true dateDE: true*/ } }});
[14]? number( )? numberDE()????? 返回:Boolean
????? 说明:用来验证小数。number()的小数点为圆点( . ),numberDE()的小数点为英文逗号( , )。
- $("#myform").validate({ rules: { field: { required: true, number: true //numberDE: true } }});
[15]? digits()????? 返回:Boolean
????? 说明:确保文本框中的值为数字。
- $("#myform").validate({ rules: { field: { required: true, digits: true } }});
[16]? digits()????? 返回:Boolean
????? 说明:确保文本框中的值为数字。
- $("#myform").validate({ rules: { field: { required: true, digits: true } }});
[17]? accept( [extension] ) ????? 返回:Boolean
????? 参数 extension(Optional)???? 类型:String??? 允许的文件后缀名,用"|"或","分割。默认为"png|jpe?g|gif"
????? 说明:确保表单元素接收给定的文件后缀名的文件。如果没有指定参数,则只有图片是允许的(png,jpeg,gif)。
- $("#myform").validate({ rules: { field: { required: true, accept: "xls|csv" } }});
[18]? equalTo( other ) ????? 返回:Boolean
????? 参数 other ???? 类型:Selector??? 要与当前值比较的另一个表单元素。
????? 说明:确保两个表单元素的值是一致的。
- $("#myform").validate({ rules: { password: "required", password_again: { equalTo: "#password" } }});
原文请见:http://docs.jquery.com/Plugins/Validation
---------------------------------------------------------------------------------