jQuery验证框架（五）验证器 (jQuery validation)

[b][size=large]jQuery验证框架[/size][/b]

[b][color=green][size=medium]五、验证器( Validator )[/size][/color][/b]
[color=#065fb9][size=small]validate方法返回的验证器对象( Validator Object) 有一些公用的方法。你可以用来触发验证程序或改变表单(form)的内容。验证器对象有更多的方法，不过只有文档中给出的这些方法是专为使用而设计的。[/size][/color]

[size=medium][b][color=#065fb9](一)验证器方法(Validator methods)[/color][/b][/size]
[size=medium][b][1][color=indigo] form() [/color][/b][/size] [color=blue]返回：Boolean[/color]
[color=olive]说明：[/color]验证表单是否通过验证，若通过验证则返回true，反之返回false。这个方法在正常的提交事件(submit event)触发，它返回一个结果。

$("#myform").validate().form();

[size=medium][b][2][color=indigo] element( element ) [/color][/b][/size] [color=blue]返回：Boolean[/color]
[color=green]参数 element [/color] [color=brown]类型：Selector[/color] 验证表单中的一个需要验证的表单元素。
[color=olive]说明：[/color]验证单个表单元素是否通过验证，若通过验证则返回true，反之返回false。这个方法在正常的焦点离开事件(blur)或按键弹起(keyup)时触发，它返回一个结果。

$("#myform").validate().element( "#myselect" );

[size=medium][b][3][color=indigo] resetForm( ) [/color][/b][/size] [color=blue]返回：undefined[/color]
[color=olive]说明：[/color]重置表单。
恢复表单元素到原来的值(需要form插件支持)，移除无效验证的样式并隐藏错误消息。
(...貌似只有在IE下才可以移除样式)

var validator = $("#myform").validate();
validator.resetForm();

[size=medium][b][4][color=indigo] showErrors( errors ) [/color][/b][/size] [color=blue]返回：undefined[/color]
[color=green]参数 errors [/color] [color=brown]类型：Object<String, String>[/color] 一个或多个表单元素的name属性和验证消息组成的键/值对。
[color=olive]说明：[/color]显示指定的验证消息。
在指定的errorPlacement中显示验证消息。键为待验证表单元素的name属性，值为相应的验证消息。

var validator = $("#myform").validate();
validator.showErrors({"firstname": "I know that your firstname is Pete, Pete!"});

[size=medium][b][5][color=indigo] numberOfInvalids( ) [/color][/b][/size] [color=blue]返回：Integer[/color]
[color=olive]说明：[/color]返回未通过验证的表单元素的个数。
这个方法依赖于内部的验证器情况。只有在验证完所有表单元素时才统计所有待验证的表单元素(submit事件或通过$("form").valid())。当只验证单个表单元素，则只有统计该表单元素。与invalidHandler选项联合使用的时候非常有用。

var validator = $("#myform").validate({
    invalidHandler: function() {
        $("#summary").text(validator.numberOfInvalids() +"field(s) areinvalid");
    }
});

[size=medium][b][color=#065fb9](二)验证器函数(Validator functions)[/color][/b][/size]
[size=medium][b][1][color=indigo] setDefaults( defaults ) [/color][/b][/size] [color=blue]返回：undefined[/color]
[color=green]参数 defaults [/color] [color=brown]类型：Options[/color] 要设置成默认值的选项。
[color=olive]说明：[/color]修改验证框架的默认设置。
接受validate方法中的所有选项。

jQuery.validator.setDefaults({ 
    debug: true 
});

[size=medium][b][2][color=indigo] addMethod( name, method, [message] ) [/color][/b][/size] [color=blue]返回：undefined[/color]
[color=green]参数 name[/color] [color=brown]类型：String[/color] 要添加的方法名，用于标识和引用，必须是一个有效的javascript标识符。
[color=green]参数 method[/color] [color=brown]类型：Callback[/color] 方法的实现部分，返回true如果表单元素通过验证。
[color=green]参数 message[/color][color=#999](Optional)[/color] [color=brown]类型：String, Function[/color] 该方法的默认验证消息。可以用 [color=indigo][b][i]jQuery.validator.format(value)[/i][/b][/color] 方法创建。如果未定义该参数，则使用本地已存在的验证消息，另外，必须为指定的表单元素定义验证消息。
[color=olive]说明：[/color]添加一个用户自定义的验证方法。它由方法名（必须是一个合法的javascript标识符）、基于javascript的函数及默认的验证消息组成。

jQuery.validator.addMethod("math", function(value, element, params) { 
    return this.optional(element) || value == params[0] + params[1]; 
}, jQuery.format("Please enter the correct value for {0} + {1}"));

[size=medium][b][3][color=indigo] addClassRules( name, rules ) [/color][/b][/size] [color=blue]返回：undefined[/color]
[color=green]参数 name[/color] [color=brown]类型：String[/color] 要添加的样式规则名。
[color=green]参数 rules[/color] [color=brown]类型：Options[/color] 规则选项。
[color=olive]说明：[/color]添加一个复合的样式验证方法。对于将多个联合使用的规则重构进单个样式中非常有用。

jQuery.validator.addClassRules("name", {
  required: true,
  minlength: 2
});

[size=medium][b][4][color=indigo] addClassRules( rules ) [/color][/b][/size] [color=blue]返回：undefined[/color]
[color=green]参数 rules[/color] [color=brown]类型：Options[/color] 样式类名-规则表。
[color=olive]说明：[/color]添加一个复合的样式验证方法。对于重构通用的联合规则非常有用。

jQuery.validator.addClassRules({
  name: {
    required: true,
    minlength: 2
  },
  zip: {
    required: true,
    digits: true,
    minlength: 5,
    maxlength: 5
  }
});

[color=green]原文请见：[/color][url]http://docs.jquery.com/Plugins/Validation[/url]

------------------------------------------------------------------------------------------------------------------------------------------------------