`
BlueFuture
  • 浏览: 53304 次
  • 性别: Icon_minigender_1
  • 来自: 大连
最近访客 更多访客>>
社区版块
存档分类
最新评论

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

jQuery框架JavaScriptFirebugHTML 
阅读更多

jQuery验证框架

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>   
<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。
验证从这个方法开始：validate( [options] )
一、可选项( options )
[1]  debug      类型：Boolean    默认：false
      说明：开启调试模式。如果为true，表单不会提交，而且会在控制台显示一些错误消息（需要Firebug或者Firebug lite）。当要阻止表单默认提交事件，尝试去开启它。

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



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

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



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

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.  })  
$(".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的表单总是被忽略的。

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



[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. })  
$(".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属性或者默认消息。消息可以是一个字符串或者一个回调函数。回调函数必须在验证器的作用域中调用，将规则参数作为回调函数的第一个参数，将该表单元素作为回调函数的第二个参数，且必须返回一个字符串类型的消息。

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. })  
$(".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代码 复制代码
  1. $(".selector").validate({   
  2.    onfocusout: false  
  3. })  
$(".selector").validate({
   onfocusout: false
})



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

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



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

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



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

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



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

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



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

Js代码 复制代码
  1. $("#myform").validate({   
  2.    meta: "validate"  
  3. })   
  4. <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"
      说明：用此设定的样式来定义错误消息的样式。

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



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

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



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

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



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

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



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

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



[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. })  
$("#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()触发默认的行为。

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.  })  
$(".selector").validate({
   showErrors: function(errorMap, errorList) {
		$("#summary").html("Your form contains "
                                   + this.numberOfInvalids() 
                                   + " errors, see details below.");
		this.defaultShowErrors();
	}
 })



[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.  })  
$("#myform").validate({
  errorPlacement: function(error, element) {
     error.appendTo( element.parent("td").next("td") );
   },
   debug:true
 })



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

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



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

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



[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. });  
$(".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工具栏引起的冲突。

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





原文地址：http://docs.jquery.com/Plugins/Validation/validate#toptions

分享到：
| Jquery属性(一) -- Attr
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    jquery.validate Validation .js验证框架 帮助 手册 文档 chm

    jquery.validate Validation .js验证框架 帮助 手册 文档.chm 版本 方面查询 （一）、可选项( options ) 1 （二）插件方法 (jQuery validation) 6 （三、四）选择器及实用工具 (jQuery validation) 7 四、实用工具...

    jquery 前端验证框架

    **二、jQuery验证框架的重要性** 前端验证不仅能够即时反馈用户输入错误，提高用户交互体验，还能减少服务器端的压力，避免无效请求。jQuery的验证框架提供了一套灵活、可定制的验证规则，使开发者可以快速构建表单...

    jQueryvalidation验证框架.pdf

    jQuery Validation 是一个强大的客户端表单验证插件，用于在用户提交数据之前检查其输入的有效性。这个框架大大简化了在HTML表单中实现复杂验证逻辑的过程。以下是对jQuery Validation框架的一些关键知识点的详细...

    jQuery验证框架

    ### jQuery验证框架详解 #### 一、概述 jQuery Validation Plugin 是一个非常强大的验证插件，它可以帮助开发者轻松地实现客户端表单验证功能。此插件是基于jQuery开发的，因此可以充分利用jQuery的强大功能来简化...

    jQuery验证框架[收集].pdf

    在使用jQuery验证框架时，我们可以设置一系列可选参数（options）来定制验证行为。例如，我们可以设定是否显示错误信息、错误信息的位置、错误信息的显示方式等。例如： ```javascript $("#myForm").validate({ ...

    jquery验证框架

    **jQuery验证框架详解** jQuery Validation 是一款非常流行的前端验证插件，主要用于在用户提交表单前进行数据验证，确保输入信息的正确性和完整性。这款框架是基于jQuery库开发的，因此，它能够轻松地与jQuery无缝...

    Jquery前端表单验证插件formvalidation源码及示例

    **jQuery FormValidation插件**是前端开发中一个广泛使用的工具，专门用于实现高效且用户友好的表单验证。这个插件基于流行的JavaScript库jQuery构建，它简化了在Web应用程序中实施复杂的验证规则的过程。在标题提到...

    JQuery验证框架

    JQuery验证框架是基于JQuery的一个轻量级插件，用于简化Web表单验证的过程。它提供了一系列的内置验证规则和自定义验证逻辑，使得开发者无需编写复杂的JavaScript代码即可实现对表单数据的有效性检查。本文将详细...

    jquery-validation-1.13.0

    jQuery Validation Plugin 是一个流行的JavaScript库，专门用于实现Web表单的数据验证。这个插件是基于jQuery框架设计的，因此，它能够轻松地与jQuery的其他功能集成，提供用户友好的交互体验。在版本1.13.0中，该...

    jquery-validation输出漂亮验证信息

    其次，我们可以通过jQuery-validation的选项和方法来定制验证行为。例如，`errorPlacement`函数可以让我们决定错误消息在页面上的位置。我们可能希望将错误信息插入到特定的HTML元素中，或者使用特定的模板来呈现。`...

    表单验证jquery插件

    jQuery Validation Engine 是一个功能强大的表单验证插件，以其简单易用和丰富的自定义选项而受到开发者的青睐。 ## 1. jQuery Validation Engine 插件简介 jQuery Validation Engine 是一款基于 jQuery 库的验证...

    jquery-validation

    总结，`jQuery Validation` 是一个强大的前端验证工具，能够有效地提升Web表单的用户体验，减少无效数据的提交，同时提供了高度的灵活性和可扩展性，使其在各种项目中都能得到广泛的应用。通过熟练掌握这个插件，...

    各种JS验证的jquery框架库

    标题提到的"各种JS验证的jquery框架库"正是针对JavaScript验证功能的一种集合，这些库通常提供了一套完整的解决方案，帮助开发者实现表单验证、数据校验等需求，从而提高用户体验和网站安全性。 jQuery的核心特性...

    jquery formValidation表单验证插件实例

    jQuery FormValidation是一款高效且灵活的JavaScript库，专为开发者提供表单验证功能。这个插件使我们能够轻松地为网页中的表单添加验证规则，确保用户输入的数据符合预设的要求，从而提高用户体验并减少服务器端的...

    JQuery验证

    总结，jQuery验证插件提供了一套完整的解决方案来处理表单验证，它易于使用，可定制性强，适用于各种规模的项目。通过熟练掌握它的使用方法和特性，可以提高前端开发效率，为用户提供更优质的交互体验。

    前端项目-jquery-validation-unobtrusive.zip

    "前端项目-jquery-validation-unobtrusive"是一个基于jQuery的验证插件，它的主要功能是在data-*属性中启用不显眼的验证选项，使得验证过程更为简洁、高效且对用户友好。本文将深入探讨这一技术的原理、使用方法以及...

    jquery校验框架

    《jQuery验证框架详解：错误提示与实践应用》 在Web开发中，用户输入的数据校验是必不可少的一环，它能够确保数据的准确性和安全性。jQuery作为一个强大的JavaScript库，提供了丰富的功能，其中包括验证框架jQuery ...

    jquery.validateValidation.js验证框架帮助手册文档.pdf

    总结，jQuery Validate 是一个强大的验证库，通过丰富的选项、方法和内置验证规则，使得在前端进行表单验证变得简单高效。它不仅可以帮助防止无效数据的提交，还能提升用户体验，确保用户输入的数据满足预设的条件。...

Magicbox
Global site tag (gtag.js) - Google Analytics