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

时间  2019-11-06
标签 jquery 验证 框架 可选项 validation 栏目 JQuery 繁體版
原文   原文链接

jQuery验证框架

javascript

Html代码
  1. <script type="text/javascript" src=js/jquery-1.3.2.min.js></script>  
  2. <script type="text/javascript" src=js/jquery.validate.pack.js></script>  
  3. <script type="text/javascript">  
  4.     $(document).ready(function(){  
  5.         $("#textForm").validate();  
  6.     });  
  7. </script>  
  8. <form class="cmxform" id="commentForm" method="get" action="">  
  9.     Name<input id="cname" name="name" size="25" class="required" minlength="2" />  
  10.         <input class="submit" type="submit" value="Submit"/>  
  11. </form>  


此文谨以以上js片断开始介绍jQuery Validation。
验证从这个方法开始：validate( [options] )
1、可选项( options )
[1]  debug      类型：Boolean    默认：false
      说明：开启调试模式。若是为true，表单不会提交，并且会在控制台显示一些错误消息（须要Firebug或者Firebug lite）。当要阻止表单默认提交事件，尝试去开启它。html

Js代码
  1. $(".selector").validate({  
  2.    debug: true  
  3. })  



[2]  submitHandler      类型：Callback    默认：default (native) form submit
      说明：当表单经过验证，提交表单。回调函数有个默认参数formjava

Js代码
  1. $(".selector").validate({  
  2.    submitHandler: function(form) {  
  3.        // do other stuff for a valid form  
  4.     form.submit();  
  5.    }  
  6. })  



[3]  invalidHandler      类型：Callback
      说明：当未经过验证的表单提交时，能够在该回调函数中处理一些事情。该回调函数有两个参数：第一个为一个事件对象，第二个为验证器（validator）jquery

Js代码
  1. $(".selector").validate({  
  2.     invalidHandler: function(form, validator) {  
  3.       var errors = validator.numberOfInvalids();  
  4.       if (errors) {  
  5.         var message = errors == 1  
  6.           ? 'You missed 1 field. It has been highlighted'  
  7.           : 'You missed ' + errors + ' fields. They have been highlighted';  
  8.         $("div.error span").html(message);  
  9.         $("div.error").show();  
  10.       } else {  
  11.         $("div.error").hide();  
  12.       }  
  13.     }  
  14.  })  



[4]  ignore      类型：Seletor
      说明：当进行表单验证时，过滤掉选择器所选择的表单。用了jQuery not方法（ not() ）。类型为submit和reset的表单老是被忽略的。app

Js代码
  1. $("#myform").validate({  
  2.    ignore: ".ignore"  
  3. })  



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

Js代码
  1. $(".selector").validate({  
  2.    rules: {  
  3.      // simple rule, converted to {required:true}  
  4.      name: "required",  
  5.      // compound rule  
  6.      email: {  
  7.        required: true,  
  8.        email: true  
  9.      }/* 
  10.      email: { 
  11.          depends: function(element) { 
  12.            return $("#contactform_email:checked") 
  13.          } 
  14.      }*/  
  15.    }  
  16. })  



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

Js代码
  1. $(".selector").validate({  
  2.    rules: {  
  3.      name: "required",  
  4.      email: {  
  5.        required: true,  
  6.        email: true  
  7.      }  
  8.    },  
  9.    messages: {  
  10.      name: "Please specify your name",  
  11.      email: {  
  12.        required: "We need your email address to contact you",  
  13.        email: "Your email address must be in the format of name@domain.com"  
  14.      }  
  15.    }  
  16. })  



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

Js代码
  1. $("#myform").validate({  
  2.   groups: {  
  3.     username: "fname lname"  
  4.   },  
  5.   errorPlacement: function(error, element) {  
  6.      if (element.attr("name") == "fname"   
  7.                  || element.attr("name") == "lname" )  
  8.        error.insertAfter("#lastname");  
  9.      else  
  10.        error.insertAfter(element);  
  11.    },  
  12.    debug:true  
  13.  })  



[8]  onsubmit      类型：Boolean    默认：true
      说明：提交时验证表单。当设置为false时，只能用其它的事件验证。函数

Js代码
  1. $(".selector").validate({  
  2.    onsubmit: false  
  3. })  



[9]  onfocusout      类型：Boolean    默认：true
      说明：焦点离开时验证（单选/复选按钮除外）。若是表单中没有输入任何内容，全部的规则将被跳过，除非该表单已经被标记为无效的。工具

Js代码
  1. $(".selector").validate({  
  2.    onfocusout: false  
  3. })  



[10]  onkeyup      类型：Boolean    默认：true
      说明：当键盘按键弹起时验证。只要表单元素没有被标记成无效的，不会有反应。另外，全部的规则将在每次按键弹起时验证。

Js代码
  1. $(".selector").validate({  
  2.    onkeyup: false  
  3. })  



[11]  onclick      类型：Boolean    默认：true
      说明：鼠标点击验证针对单选和复选按钮。

Js代码
  1. $(".selector").validate({  
  2.    onclick: false  
  3. })  



[12]  focusInvalid      类型：Boolean    默认：true
      说明：当验证无效时，焦点跳到第一个无效的表单元素。当为false时，验证无效时，没有焦点响应。

Js代码
  1. $(".selector").validate({  
  2.    focusInvalid: false  
  3. })  



[12]  focusCleanup      类型：Boolean    默认：false
      说明：若是为true，当表单获得焦点时，移除在该表单上的errorClass并隐藏全部错误消息。避免与focusInvalid一块儿使用。

Js代码
  1. $(".selector").validate({  
  2.    focusCleanup: true  
  3. })  



[13]  meta      类型：String
      说明：若是想使用其它插件来使用元数据验证规则，得指定相应的元数据对象。

Js代码
  1. $("#myform").validate({  
  2.    meta: "validate"  
  3. })  
  4. <input type="text" name="email" class="{validate:{ required: true, email:true}}" />  



[14]  errorClass      类型：String    默认："error"
      说明：用此设定的样式来定义错误消息的样式。

Js代码
  1. $(".selector").validate({  
  2.    errorClass: "invalid"  
  3. })  



[15]  validClass      类型：String    默认："valid"
      说明：设定当验证经过时，消息显示的样式。

Js代码
  1. $(".selector").validate({  
  2.    validClass: "success"  
  3. })  



[16]  errorElement      类型：String    默认："label"
      说明：用html元素类型建立错误消息的容器。默认的"label"有个优势就是能在错误消息与无效表单之间用for属性创建有意义的联系（一个经常使用的，而无论表单元素是什么的）。

Js代码
  1. $(".selector").validate({  
  2.    errorElement: "em"  
  3. })  



[17]  wrapper      类型：Boolean
      说明：用一个指定的元素将错误消息包围。与errorLabelContainer一块儿建立一个错误消息列表很是有用。

Js代码
  1. $(".selector").validate({  
  2.    wrapper: "li"  
  3. })  



[18]  errorLabelContainer      类型：Selector
      说明：错误消息标签的容器。

Js代码
  1. $("#myform").validate({  
  2.    errorLabelContainer: "#messageBox",  
  3.    wrapper: "li"  
  4. })  



[19]  errorContainer      类型：Selector
      说明：错误消息的容器。

Js代码
  1. $("#myform").validate({  
  2.    errorContainer: "#messageBox1, #messageBox2",  
  3.    errorLabelContainer: "#messageBox1 ul",  
  4.    wrapper: "li", debug:true,  
  5.    submitHandler: function() { alert("Submitted!") }  
  6. })  



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

Js代码
  1. $(".selector").validate({  
  2.    showErrors: function(errorMap, errorList) {  
  3.         $("#summary").html("Your form contains "  
  4.                                    + this.numberOfInvalids()   
  5.                                    + " errors, see details below.");  
  6.         this.defaultShowErrors();  
  7.     }  
  8.  })  



[21]  errorPlacement      类型：Callback    默认：紧跟在无效表单后的标签中
      说明：用户自定义错误标签的显示位置。第一个参数：一个做为jQuery对象的错误标签，第二个参数为：一个做为jQuery对象的未经过验证的表单元素。

Js代码
  1. $("#myform").validate({  
  2.   errorPlacement: function(error, element) {  
  3.      error.appendTo( element.parent("td").next("td") );  
  4.    },  
  5.    debug:true  
  6.  })  



[22]  success      类型：String,Callback
      说明：若是指定它，当验证经过时显示一个消息。若是是String类型的，则添加该样式到标签中，若是是一个回调函数，则将标签做为其惟一的参数。

Js代码
  1. $("#myform").validate({  
  2.    //success: "valid",  
  3.      success: function(label) {  
  4.          label.addClass("valid").text("Ok!")  
  5.      }  
  6. })  



[23]  highlight      类型：Callback    默认：添加errorClass到表单元素
      说明：将未经过验证的表单元素设置高亮。

Js代码
  1. $(".selector").validate({  
  2.   highlight: function(element, errorClass) {  
  3.      $(element).fadeOut(function() {  
  4.        $(element).fadeIn()  
  5.      })  
  6.   }  
  7. })  



[24]  unhighlight      类型：Callback    默认：移除errorClass
      说明：与highlight操做相反

Js代码
  1. $(".selector").validate({  
  2.   highlight: function(element, errorClass) {  
  3.      $(element).addClass(errorClass);  
  4.      $(element.form).find("label[for=" + element.id + "]")  
  5.                     .addClass(errorClass);  
  6.   },  
  7.   unhighlight: function(element, errorClass) {  
  8.      $(element).removeClass(errorClass);  
  9.      $(element.form).find("label[for=" + element.id + "]")  
  10.                     .removeClass(errorClass);  
  11.   }  
  12. });  



[25]  ignoreTitle      类型：Boolean    默认：false
      说明：设置它用来跳过错误消息对title属性的引用，避免Google工具栏引发的冲突。

Js代码
  1. $(".selector").validate({  
  2.    ignoreTitle: true  
  3. }) 
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程