jQuery验证框架（一） 可选项 (jQuery validation)

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

<script type="text/javascript" src=js/jquery-1.3.2.min.js></script>
<script type="text/javascript" src=js/jquery.validate.pack.js></script>
<script type="text/javascript">
    $(document).ready(function(){
        $("#textForm").validate();
    });
</script>
<form class="cmxform" id="commentForm" method="get" action="">
    Name<input id="cname" name="name" size="25" class="required" minlength="2" />
        <input class="submit" type="submit" value="Submit"/>
</form>

此文谨以以上js片段开始介绍jQuery Validation。
验证从这个方法开始：[color=#065FB9][size=medium][b]validate( [options] )[/b][/size][/color]
[b][color=green][size=medium]一、可选项( options )[/size][/color][/b]
[size=medium][b][1][color=indigo] debug[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：false[/color]
[color=olive]说明：[/color]开启调试模式。如果为true，表单不会提交，而且会在控制台显示一些错误消息（需要Firebug或者Firebug lite）。当要阻止表单默认提交事件，尝试去开启它。

$(".selector").validate({
   debug: true
})

[size=medium][b][2][color=indigo] submitHandler[/color][/b][/size] [color=blue]类型：Callback[/color] [color=#999]默认：default (native) form submit[/color]
[color=olive]说明：[/color]当表单通过验证，提交表单。回调函数有个默认参数form

$(".selector").validate({
   submitHandler: function(form) {
       // do other stuff for a valid form
   	form.submit();
   }
})

[size=medium][b][3][color=indigo] invalidHandler[/color][/b][/size] [color=blue]类型：Callback[/color]
[color=olive]说明：[/color]当未通过验证的表单提交时，可以在该回调函数中处理一些事情。该回调函数有两个参数：第一个为一个事件对象，第二个为验证器（validator）

$(".selector").validate({
    invalidHandler: function(form, validator) {
      var errors = validator.numberOfInvalids();
      if (errors) {
        var message = errors == 1
          ? 'You missed 1 field. It has been highlighted'
          : 'You missed ' + errors + ' fields. They have been highlighted';
        $("div.error span").html(message);
        $("div.error").show();
      } else {
        $("div.error").hide();
      }
    }
 })

[size=medium][b][4][color=indigo] ignore[/color][/b][/size] [color=blue]类型：Seletor[/color]
[color=olive]说明：[/color]当进行表单验证时，过滤掉选择器所选择的表单。用了jQuery not方法（ not() ）。类型为submit和reset的表单总是被忽略的。

$("#myform").validate({
   ignore: ".ignore"
})

[size=medium][b][5][color=indigo] rules[/color][/b][/size] [color=blue]类型：Options[/color] [color=#999]默认：rules are read from markup (classes, attributes, metadata)[/color]
[color=olive]说明：[/color]用户定义的键/值对规则。键为一个表单元素的name属性（或是一组单选/复选按钮）、值为一个简单的字符串或者由规则/参数对（rule/parameter）组成的一个对象。可以和 class/attribute/metadata 规则一起使用。每个规则可以指定一个依存的验证前提条件。

$(".selector").validate({
   rules: {
     // simple rule, converted to {required:true}
     name: "required",
     // compound rule
     email: {
       required: true,
       email: true
     }/*
     email: {
         depends: function(element) {
           return $("#contactform_email:checked")
         }
     }*/
   }
})

[size=medium][b][6][color=indigo] messages[/color][/b][/size] [color=blue]类型：Options[/color] [color=#999]默认：验证方法默认使用的消息[/color]
[color=olive]说明：[/color]用户自定义的 键/值 对消息。键为一个表单元素的name属性，值为该表单元素将要显示的消息。该消息覆盖元素的title属性或者默认消息。消息可以是一个字符串或者一个回调函数。回调函数必须在验证器的作用域中调用，将规则参数作为回调函数的第一个参数，将该表单元素作为回调函数的第二个参数，且必须返回一个字符串类型的消息。

$(".selector").validate({
   rules: {
     name: "required",
     email: {
       required: true,
       email: true
     }
   },
   messages: {
     name: "Please specify your name",
     email: {
       required: "We need your email address to contact you",
       email: "Your email address must be in the format of name@domain.com"
     }
   }
})

[size=medium][b][7][color=indigo] groups[/color][/b][/size] [color=blue]类型：Options[/color]
[color=olive]说明：[/color]指定错误消息分组。一个组由一个任意的组名作为键，一个由空白符分割的表单元素name属性列表作为值。用errorPlacement定义组消息的存放位置。

$("#myform").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);
   },
   debug:true
 })

[size=medium][b][8][color=indigo] onsubmit[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：true[/color]
[color=olive]说明：[/color]提交时验证表单。当设置为false时，只能用其它的事件验证。

$(".selector").validate({
   onsubmit: false
})

[size=medium][b][9][color=indigo] onfocusout[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：true[/color]
[color=olive]说明：[/color]焦点离开时验证（单选/复选按钮除外）。如果表单中没有输入任何内容，所有的规则将被跳过，除非该表单已经被标记为无效的。

$(".selector").validate({
   onfocusout: false
})

[size=medium][b][10][color=indigo] onkeyup[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：true[/color]
[color=olive]说明：[/color]当键盘按键弹起时验证。只要表单元素没有被标记成无效的，不会有反应。另外，所有的规则将在每次按键弹起时验证。

$(".selector").validate({
   onkeyup: false
})

[size=medium][b][11][color=indigo] onclick[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：true[/color]
[color=olive]说明：[/color]鼠标点击验证针对单选和复选按钮。

$(".selector").validate({
   onclick: false
})

[size=medium][b][12][color=indigo] focusInvalid[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：true[/color]
[color=olive]说明：[/color]当验证无效时，焦点跳到第一个无效的表单元素。当为false时，验证无效时，没有焦点响应。

$(".selector").validate({
   focusInvalid: false
})

[size=medium][b][12][color=indigo] focusCleanup[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：false[/color]
[color=olive]说明：[/color]如果为true，当表单得到焦点时，移除在该表单上的errorClass并隐藏所有错误消息。避免与focusInvalid一起使用。

$(".selector").validate({
   focusCleanup: true
})

[size=medium][b][13][color=indigo] meta[/color][/b][/size] [color=blue]类型：String[/color]
[color=olive]说明：[/color]如果想使用其它插件来使用元数据验证规则，得指定相应的元数据对象。

$("#myform").validate({
   meta: "validate"
})
<input type="text" name="email" class="{validate:{ required: true, email:true}}" />

[size=medium][b][14][color=indigo] errorClass[/color][/b][/size] [color=blue]类型：String[/color] [color=#999]默认："error"[/color]
[color=olive]说明：[/color]用此设定的样式来定义错误消息的样式。

$(".selector").validate({
   errorClass: "invalid"
})

[size=medium][b][15][color=indigo] validClass[/color][/b][/size] [color=blue]类型：String[/color] [color=#999]默认："valid"[/color]
[color=olive]说明：[/color]设定当验证通过时，消息显示的样式。

$(".selector").validate({
   validClass: "success"
})

[size=medium][b][16][color=indigo] errorElement[/color][/b][/size] [color=blue]类型：String[/color] [color=#999]默认："label"[/color]
[color=olive]说明：[/color]用html元素类型创建错误消息的容器。默认的"label"有个优点就是能在错误消息与无效表单之间用for属性建立有意义的联系（一个常常使用的，而不管表单元素是什么的）。

$(".selector").validate({
   errorElement: "em"
})

[size=medium][b][17][color=indigo] wrapper[/color][/b][/size] [color=blue]类型：Boolean[/color]
[color=olive]说明：[/color]用一个指定的元素将错误消息包围。与errorLabelContainer一起创建一个错误消息列表非常有用。

$(".selector").validate({
   wrapper: "li"
})

[size=medium][b][18][color=indigo] errorLabelContainer[/color][/b][/size] [color=blue]类型：Selector[/color]
[color=olive]说明：[/color]错误消息标签的容器。

$("#myform").validate({
   errorLabelContainer: "#messageBox",
   wrapper: "li"
})

[size=medium][b][19][color=indigo] errorContainer[/color][/b][/size] [color=blue]类型：Selector[/color]
[color=olive]说明：[/color]错误消息的容器。

$("#myform").validate({
   errorContainer: "#messageBox1, #messageBox2",
   errorLabelContainer: "#messageBox1 ul",
   wrapper: "li", debug:true,
   submitHandler: function() { alert("Submitted!") }
})

[size=medium][b][20][color=indigo] showErrors[/color][/b][/size] [color=blue]类型：Callback[/color] [color=#999]默认：None,内置的显示消息[/color]
[color=olive]说明：[/color]自定义消息显示的句柄。该回调函数有两个参数，第一个为errorMap,第二个参数为errorList，在validator对象的上下文中调用。参数只包含那些经过onblur/onkeyup验证的表单元素，也有可能是单个元素。除此之外，你还可以用this.defaultShowErrors()触发默认的行为。

$(".selector").validate({
   showErrors: function(errorMap, errorList) {
		$("#summary").html("Your form contains "
                                   + this.numberOfInvalids() 
                                   + " errors, see details below.");
		this.defaultShowErrors();
	}
 })

[size=medium][b][21][color=indigo] errorPlacement[/color][/b][/size] [color=blue]类型：Callback[/color] [color=#999]默认：紧跟在无效表单后的标签中[/color]
[color=olive]说明：[/color]用户自定义错误标签的显示位置。第一个参数：一个作为jQuery对象的错误标签，第二个参数为：一个作为jQuery对象的未通过验证的表单元素。

$("#myform").validate({
  errorPlacement: function(error, element) {
     error.appendTo( element.parent("td").next("td") );
   },
   debug:true
 })

[size=medium][b][22][color=indigo] success[/color][/b][/size] [color=blue]类型：String,Callback[/color]
[color=olive]说明：[/color]如果指定它，当验证通过时显示一个消息。如果是String类型的，则添加该样式到标签中，如果是一个回调函数，则将标签作为其唯一的参数。

$("#myform").validate({
   //success: "valid",
     success: function(label) {
         label.addClass("valid").text("Ok!")
     }
})

[size=medium][b][23][color=indigo] highlight[/color][/b][/size] [color=blue]类型：Callback[/color] [color=#999]默认：添加errorClass到表单元素[/color]
[color=olive]说明：[/color]将未通过验证的表单元素设置高亮。

$(".selector").validate({
  highlight: function(element, errorClass) {
     $(element).fadeOut(function() {
       $(element).fadeIn()
     })
  }
})

[size=medium][b][24][color=indigo] unhighlight[/color][/b][/size] [color=blue]类型：Callback[/color] [color=#999]默认：移除errorClass[/color]
[color=olive]说明：[/color]与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);
  }
});

[size=medium][b][25][color=indigo] ignoreTitle[/color][/b][/size] [color=blue]类型：Boolean[/color] [color=#999]默认：false[/color]
[color=olive]说明：[/color]设置它用来跳过错误消息对title属性的引用，避免Google工具栏引起的冲突。

$(".selector").validate({
   ignoreTitle: true
})

[color=green][size=small]原文地址：[url]http://docs.jquery.com/Plugins/Validation/validate#toptions[/url][/size][/color]


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