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 要与当前值比较的另一个表单元素。
说明:确保两个表单元素的值是一致的。