`
269629151
  • 浏览: 122111 次
社区版块
存档分类
最新评论

Jquery validate框架学习

    博客分类:
  • web
阅读更多

、可选项( options ) 

[1]  debug      类型:Boolean    默认:false 

      说明:开启调试模式。如果为true,表单不会提交,而且会在控制台显示一些错误消息(需要Firebug或者Firebug lite)。当要阻止表单默认提交事件,尝试去开启它。 

$(".selector").validate({   

   debug: true  

})  

$(".selector").validate({

   debug: true

})

[2]  submitHandler      类型:Callback    默认:default (native) form submit 

      说明:当表单通过验证,提交表单。回调函数有个默认参数form 

$(".selector").validate({   

   submitHandler: function(form) {   

       // do other stuff for a valid form   

    form.submit();   

   }   

})  

$(".selector").validate({

   submitHandler: function(form) {

       // do other stuff for a valid form

    form.submit();

   }

})

[3]  invalidHandler      类型:Callback 

      说明:当未通过验证的表单提交时,可以在该回调函数中处理一些事情。该回调函数有两个参数:第一个为一个事件对象,第二个为验证器(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();   

      }   

    }   

 })  

$(".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();

      }

    }

 })

[4]  ignore      类型:Seletor 

      说明:当进行表单验证时,过滤掉选择器所选择的表单。用了jQuery not方法( not() )。类型为submit和reset的表单总是被忽略的。 

$("#myform").validate({   

   ignore: ".ignore"  

})  

$("#myform").validate({

   ignore: ".ignore"

})

[5]  rules      类型:Options    默认:rules are read from markup (classes, attributes, metadata) 

      说明:用户定义的键/值对规则。键为一个表单元素的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")  

         }  

     }*/  

   }   

})  

$(".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")

         }

     }*/

   }

})

[6]  messages      类型:Options    默认:验证方法默认使用的消息 

      说明:用户自定义的 键/值 对消息。键为一个表单元素的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"  

     }   

   }   

})  

$(".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"

     }

   }

})

[7]  groups      类型:Options 

      说明:指定错误消息分组。一个组由一个任意的组名作为键,一个由空白符分割的表单元素name属性列表作为值。用errorPlacement定义组消息的存放位置。 

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.  })  

$("#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

 })

[8]  onsubmit      类型:Boolean    默认:true 

      说明:提交时验证表单。当设置为false时,只能用其它的事件验证。 

Js代码 

1. $(".selector").validate({   

2.    onsubmit: false  

3. })  

$(".selector").validate({

   onsubmit: false

})

[9]  onfocusout      类型:Boolean    默认:true 

      说明:焦点离开时验证(单选/复选按钮除外)。如果表单中没有输入任何内容,所有的规则将被跳过,除非该表单已经被标记为无效的。 

Js代码 

$(".selector").validate({   

   onfocusout: false  

})  

$(".selector").validate({

   onfocusout: false

})

[10]  onkeyup      类型:Boolean    默认:true 

      说明:当键盘按键弹起时验证。只要表单元素没有被标记成无效的,不会有反应。另外,所有的规则将在每次按键弹起时验证。 

$(".selector").validate({   

   onkeyup: false  

})  

$(".selector").validate({

   onkeyup: false

})

[11]  onclick      类型:Boolean    默认:true 

      说明:鼠标点击验证针对单选和复选按钮。 

$(".selector").validate({   

   onclick: false  

})  

$(".selector").validate({

   onclick: false

})

[12]  focusInvalid      类型:Boolean    默认:true 

      说明:当验证无效时,焦点跳到第一个无效的表单元素。当为false时,验证无效时,没有焦点响应。 

$(".selector").validate({   

   focusInvalid: false  

})  

$(".selector").validate({

   focusInvalid: false

})

[12]  focusCleanup      类型:Boolean    默认:false 

      说明:如果为true,当表单得到焦点时,移除在该表单上的errorClass并隐藏所有错误消息。避免与focusInvalid一起使用。 

$(".selector").validate({   

   focusCleanup: true  

})  

$(".selector").validate({

   focusCleanup: true

})

[13]  meta      类型:String 

      说明:如果想使用其它插件来使用元数据验证规则,得指定相应的元数据对象。 

$("#myform").validate({   

   meta: "validate"  

})   

<input type="text" name="email" class="{validate:{ required: true, email:true}}" />  

$("#myform").validate({

   meta: "validate"

})

<input type="text" name="email" class="{validate:{ required: true, email:true}}" />

[14]  errorClass      类型:String    默认:"error" 

      说明:用此设定的样式来定义错误消息的样式。 

$(".selector").validate({   

   errorClass: "invalid"  

})  

$(".selector").validate({

   errorClass: "invalid"

})

[15]  validClass      类型:String    默认:"valid" 

      说明:设定当验证通过时,消息显示的样式。 

$(".selector").validate({   

   validClass: "success"  

})  

$(".selector").validate({

   validClass: "success"

})

[16]  errorElement      类型:String    默认:"label" 

      说明:用html元素类型创建错误消息的容器。默认的"label"有个优点就是能在错误消息与无效表单之间用for属性建立有意义的联系(一个常常使用的,而不管表单元素是什么的)。 

$(".selector").validate({   

   errorElement: "em"  

})  

$(".selector").validate({

   errorElement: "em"

})

[17]  wrapper      类型:Boolean 

      说明:用一个指定的元素将错误消息包围。与errorLabelContainer一起创建一个错误消息列表非常有用。 

$(".selector").validate({   

   wrapper: "li"  

})  

$(".selector").validate({

   wrapper: "li"

})

[18]  errorLabelContainer      类型:Selector 

      说明:错误消息标签的容器。 

$("#myform").validate({   

   errorLabelContainer: "#messageBox",   

   wrapper: "li"  

})  

$("#myform").validate({

   errorLabelContainer: "#messageBox",

   wrapper: "li"

})

[19]  errorContainer      类型:Selector 

      说明:错误消息的容器。 

$("#myform").validate({   

   errorContainer: "#messageBox1, #messageBox2",   

   errorLabelContainer: "#messageBox1 ul",   

   wrapper: "li", debug:true,   

   submitHandler: function() { alert("Submitted!") }   

})  

$("#myform").validate({

   errorContainer: "#messageBox1, #messageBox2",

   errorLabelContainer: "#messageBox1 ul",

   wrapper: "li", debug:true,

   submitHandler: function() { alert("Submitted!") }

})

[20]  showErrors      类型:Callback    默认:None,内置的显示消息 

      说明:自定义消息显示的句柄。该回调函数有两个参数,第一个为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();   

    }   

 })  

$(".selector").validate({

   showErrors: function(errorMap, errorList) {

$("#summary").html("Your form contains "

                                   + this.numberOfInvalids() 

                                   + " errors, see details below.");

this.defaultShowErrors();

}

 })

[21]  errorPlacement      类型:Callback    默认:紧跟在无效表单后的标签中 

      说明:用户自定义错误标签的显示位置。第一个参数:一个作为jQuery对象的错误标签,第二个参数为:一个作为jQuery对象的未通过验证的表单元素。 

$("#myform").validate({   

  errorPlacement: function(error, element) {   

     error.appendTo( element.parent("td").next("td") );   

   },   

   debug:true  

 })  

$("#myform").validate({

  errorPlacement: function(error, element) {

     error.appendTo( element.parent("td").next("td") );

   },

   debug:true

 })

[22]  success      类型:String,Callback 

      说明:如果指定它,当验证通过时显示一个消息。如果是String类型的,则添加该样式到标签中,如果是一个回调函数,则将标签作为其唯一的参数。 

$("#myform").validate({   

   //success: "valid",   

     success: function(label) {   

         label.addClass("valid").text("Ok!")   

     }   

})  

$("#myform").validate({

   //success: "valid",

     success: function(label) {

         label.addClass("valid").text("Ok!")

     }

})

[23]  highlight      类型:Callback    默认:添加errorClass到表单元素 

      说明:将未通过验证的表单元素设置高亮。 

$(".selector").validate({   

  highlight: function(element, errorClass) {   

     $(element).fadeOut(function() {   

       $(element).fadeIn()   

     })   

  }   

})  

$(".selector").validate({

  highlight: function(element, errorClass) {

     $(element).fadeOut(function() {

       $(element).fadeIn()

     })

  }

})

[24]  unhighlight      类型:Callback    默认:移除errorClass 

      说明:与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);   

  }   

});  

$(".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);

  }

});

[25]  ignoreTitle      类型:Boolean    默认:false 

      说明:设置它用来跳过错误消息对title属性的引用,避免Google工具栏引起的冲突。 

$(".selector").validate({   

   ignoreTitle: true  

})  

$(".selector").validate({

   ignoreTitle: true

})validator.resetForm();  

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

validator.resetForm();

[4]  showErrors( errors )       返回:undefined 

      参数 errors      类型:Object<String, String>    一个或多个表单元素的name属性和验证消息组成的键/值对。 

      说明:显示指定的验证消息。 

                  在指定的errorPlacement中显示验证消息。键为待验证表单元素的name属性,值为相应的验证消息。 

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

validator.showErrors({"firstname": "I know that your firstname is Pete, Pete!"});  

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

validator.showErrors({"firstname": "I know that your firstname is Pete, Pete!"});

[5]  numberOfInvalids( )       返回:Integer 

      说明:返回未通过验证的表单元素的个数。 

                  这个方法依赖于内部的验证器情况。只有在验证完所有表单元素时才统计所有待验证的表单元素(submit事件或通过$("form").valid())。当只验证单个表单元素,则只有统计该表单元素。与invalidHandler选项联合使用的时候非常有用。 

var validator = $("#myform").validate({   

    invalidHandler: function() {   

        $("#summary").text(validator.numberOfInvalids() +"field(s) areinvalid");   

    }   

});  

var validator = $("#myform").validate({

    invalidHandler: function() {

        $("#summary").text(validator.numberOfInvalids() +"field(s) areinvalid");

    }

});

(二)验证器函数(Validator functions) 

[1]  setDefaults( defaults )       返回:undefined 

      参数 defaults      类型:Options    要设置成默认值的选项。 

      说明:修改验证框架的默认设置。 

                  接受validate方法中的所有选项。 

jQuery.validator.setDefaults({    

    debug: true    

});  

jQuery.validator.setDefaults({ 

    debug: true 

});

[2]  addMethod( name, method, [message] )       返回:undefined 

      参数 name     类型:String    要添加的方法名,用于标识和引用,必须是一个有效的javascript标识符。 

      参数 method     类型:Callback    方法的实现部分,返回true如果表单元素通过验证。 

      参数 message(Optional)     类型:String, Function    该方法的默认验证消息。可以用 jQuery.validator.format(value) 方法创建。如果未定义该参数,则使用本地已存在的验证消息,另外,必须为指定的表单元素定义验证消息。 

      说明:添加一个用户自定义的验证方法。它由方法名(必须是一个合法的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}"));  

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}"));

[3]  addClassRules( name, rules )       返回:undefined 

      参数 name     类型:String    要添加的样式规则名。 

      参数 rules     类型:Options    规则选项。 

      说明:添加一个复合的样式验证方法。对于将多个联合使用的规则重构进单个样式中非常有用。 

jQuery.validator.addClassRules("name", {   

  required: true,   

  minlength: 2   

});  

jQuery.validator.addClassRules("name", {

  required: true,

  minlength: 2

});

[4]  addClassRules( rules )       返回:undefined 

      参数 rules     类型:Options    样式类名-规则表。 

      说明:添加一个复合的样式验证方法。对于重构通用的联合规则非常有用。 

jQuery.validator.addClassRules({   

  name: {   

    required: true,   

    minlength: 2   

  },   

  zip: {   

    required: true,   

    digits: true,   

    minlength: 5,   

    maxlength: 5   

  }   

});  

jQuery.validator.addClassRules({

  name: {

    required: true,

    minlength: 2

  },

  zip: {

    required: true,

    digits: true,

    minlength: 5,

    maxlength: 5

  }

});

<!--EndFragment-->
分享到:
评论

相关推荐

    jquery validate依赖包及其帮助文档.rar

    jQuery Validate是一个强大的JavaScript库,专为jQuery框架设计,用于简化和优化HTML表单的验证过程。本篇文章将深入探讨jQuery Validate的依赖、核心功能、使用方法以及相关文档资源。 首先,jQuery Validate依赖...

    jquery-validate验证框架使用详解及JS文件

    jQuery Validate框架极大地简化了客户端表单验证,它提供了丰富的预设规则和自定义功能,可以灵活地处理各种验证需求。通过学习和实践,开发者可以快速地在项目中应用这个强大的验证工具,提升用户体验,减少无效...

    jquery validate验证示例

    `jQuery Validate` 是一个流行的 JavaScript 库,用于在客户端对 HTML 表单进行验证,确保用户输入的数据符合预设的规则。...这个压缩包中的示例和资源无疑是一个很好的学习起点,让开发者快速上手 `jQuery Validate`。

    jquery_validate之学习

    jQuery Validate是一个强大的JavaScript库,它为jQuery框架提供了简单易用的表单验证功能。这个插件以其灵活性和丰富的定制选项,深受开发者喜爱。本文将深入探讨jQuery Validate的使用方法、核心功能和常见应用场景...

    jquery验证框架学习

    【jQuery验证框架学习】 jQuery是一个广泛使用的JavaScript库,它的核心特性是简化HTML文档遍历、事件处理、动画设计和Ajax交互。本教程旨在带你深入了解jQuery验证框架,这是一套用于前端数据验证的工具,能够帮助...

    springmvc+mybatis+maven+bootstrap前端+jquery validate表单验证,web开发框架

    在本项目中,`jquery validate` 插件用于表单验证,它可以轻松地对用户输入进行实时验证,确保数据的完整性和准确性。 项目中的例子展示了如何使用SSM框架进行数据查询和添加。通常,这会涉及到以下几个步骤: 1. ...

    jquery.validate.js jquery表单验证

    在 `jquery.validate.js` 中,jQuery 被用作基础框架,提供了一套简化的 API 来处理表单验证。 2. **jQuery Validate 插件**:`jquery.validate.js` 文件是这个插件的核心,它扩展了 jQuery 的功能,允许开发者添加...

    jQuery验证框架学习笔记.pdf

    ### jQuery验证框架学习笔记知识点概览 #### 一、引言 jQuery 验证框架是基于 jQuery 开发的一个用于前端表单验证的强大插件。它提供了丰富的验证规则和灵活的配置选项,使得开发者能够轻松地实现对用户输入数据的...

    jquery validate.js表单验证的基本用法入门

    通过本文的学习,我们不仅了解了jQuery Validate插件的基本用法,还深入探讨了一个具体的表单验证实例。jQuery Validate插件的强大之处在于其灵活的配置选项和丰富的验证规则,这使得开发者可以根据实际需求定制出...

    jquery的validate表单验证框架

    `jQuery Validate`是一个非常流行的JavaScript库,用于在前端进行表单验证。这个框架极大地简化了在网页表单中实现复杂验证逻辑的过程...通过学习和掌握这个框架,开发者可以为用户提供更加友好、流畅的表单交互体验。

    jquery校验框架

    总结,jQuery Validate框架提供了一套强大且易用的表单验证解决方案,通过自定义错误提示,我们可以打造出符合项目需求的交互体验。无论是初学者还是经验丰富的开发者,都能从中受益,提升Web应用的质量和用户体验。

    jqueryvalidate(猫冬)+spring3.0+struts2.18+hibernate3整合资源包

    该资源包是一个集成开发环境下的项目模板,主要涵盖了jQuery Validate、Spring 3.0、Struts 2.18和Hibernate 3这四个关键组件,它们是Java Web开发中的常用框架和技术。以下将分别对这些技术进行详细阐述。 **...

    AmezeUI框架+jquery-validate

    本项目涉及的知识点主要集中在"AmezeUI框架"和"jquery-validate"这两个工具的结合使用上,用于实现一个高效的注册验证系统。 首先,**AmezeUI框架**是一个专为移动互联网设计的前端框架,它提供了丰富的组件和样式...

    jquery-validateEngine验证框架小demo

    `jQuery Validate Engine`是一个强大的表单验证插件,它扩展了`jQuery`的功能,使得开发者可以轻松地为网页表单创建美观且功能丰富的验证规则。这个小`demo`旨在帮助理解如何集成和使用该框架。 在`jQuery Validate...

    jQuery学习框架

    **jQuery学习框架** jQuery是一个广泛使用的JavaScript库,它极大地简化了HTML文档遍历、事件处理、动画制作和Ajax交互。这个框架使得前端开发者能够更高效地编写可维护、高性能的代码。在本教程中,我们将深入探讨...

    基于Bootstrap与jQuery-validate的个人封装检验框架demo

    总结来说,"基于Bootstrap与jQuery-validate的个人封装检验框架demo"是一个实用的学习资源,它展示了如何将前端设计与验证功能有效融合,创建出具有良好UI和用户体验的验证框架。通过学习和理解这个项目,开发者可以...

    jquery 前端验证框架

    **jQuery前端验证框架详解** 在Web开发中,前端验证是必不可少的一个环节,它能有效防止无效数据提交到服务器,提高用户体验并减轻服务器负担。jQuery,作为一款广泛使用的JavaScript库,提供了许多工具和插件来...

Global site tag (gtag.js) - Google Analytics