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