jQuery Validate验证框架详解(推荐)

发布时间 - 2026-01-10 21:54:02    点击率:

jQuery Validate 插件为表单提供了强大的验证功能,让客户端表单验证变得更简单,同时提供了大量的定制选项,满足应用程序各种需求。

一、导入js库

<script type="text/javascript" src="<%=path %>/validate/jquery-1.6.2.min.js"></script>
<script type="text/javascript" src="<%=path %>/validate/jquery.validate.min.js"></script>

注:<%=request.getContextPath() %>返回web项目的根路径。

二、默认校验规则

(1)、required:true               必输字段

(2)、remote:"remote-valid.jsp"   使用ajax方法调用remote-valid.jsp验证输入值

(3)、email:true                  必须输入正确格式的电子邮件

(4)、url:true                    必须输入正确格式的网址

(5)、date:true                   必须输入正确格式的日期,日期校验ie6出错,慎用

(6)、dateISO:true                必须输入正确格式的日期(ISO),例如:2009-06-23,1998/01/22 只验证格式,不验证有效性

(7)、number:true                 必须输入合法的数字(负数,小数)

(8)、digits:true                 必须输入整数

(9)、creditcard:true             必须输入合法的信用卡号

(10)、equalTo:"#password"        输入值必须和#password相同

(11)、accept:                    输入拥有合法后缀名的字符串(上传文件的后缀)

(12)、maxlength:5                输入长度最多是5的字符串(汉字算一个字符)

(13)、minlength:10               输入长度最小是10的字符串(汉字算一个字符)

(14)、rangelength:[5,10]         输入长度必须介于 5 和 10 之间的字符串")(汉字算一个字符)

(15)、range:[5,10]               输入值必须介于 5 和 10 之间

(16)、max:5                      输入值不能大于5

(17)、min:10                     输入值不能小于10

三、默认的提示

messages: {
required: "This field is required.",
remote: "Please fix this field.",
email: "Please enter a valid email address.",
url: "Please enter a valid URL.",
date: "Please enter a valid date.",
dateISO: "Please enter a valid date (ISO).",
dateDE: "Bitte geben Sie ein g眉ltiges Datum ein.",
number: "Please enter a valid number.",
numberDE: "Bitte geben Sie eine Nummer ein.",
digits: "Please enter only digits",
creditcard: "Please enter a valid credit card number.",
equalTo: "Please enter the same value again.",
accept: "Please enter a value with a valid extension.",
maxlength: $.validator.format("Please enter no more than {0} characters."),
minlength: $.validator.format("Please enter at least {0} characters."),
rangelength: $.validator.format("Please enter a value between {0} and {1} characters long."),
range: $.validator.format("Please enter a value between {0} and {1}."),
max: $.validator.format("Please enter a value less than or equal to {0}."),
min: $.validator.format("Please enter a value greater than or equal to {0}.")
},

如需要修改,可在js代码中加入:

$.extend($.validator.messages, {
  required: "必选字段",
  remote: "请修正该字段",
  email: "请输入正确格式的电子邮件",
  url: "请输入合法的网址",
  date: "请输入合法的日期",
  dateISO: "请输入合法的日期 (ISO).",
  number: "请输入合法的数字",
  digits: "只能输入整数",
  creditcard: "请输入合法的信用卡号",
  equalTo: "请再次输入相同的值",
  accept: "请输入拥有合法后缀名的字符串",
  maxlength: $.validator.format("请输入一个长度最多是 {0} 的字符串"),
  minlength: $.validator.format("请输入一个长度最少是 {0} 的字符串"),
  rangelength: $.validator.format("请输入一个长度介于 {0} 和 {1} 之间的字符串"),
  range: $.validator.format("请输入一个介于 {0} 和 {1} 之间的值"),
  max: $.validator.format("请输入一个最大为 {0} 的值"),
  min: $.validator.format("请输入一个最小为 {0} 的值")
});

推荐做法,将此文件放入messages_cn.js中,在页面中引入

<script type="text/javascript" src="<%=path %>/validate/messages_cn.js"></script>

四、使用方式

1、metadata用法,将校验规则写到控件中

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
  String path = request.getContextPath();
  String basePath = request.getScheme() + "://" + request.getServerName() + ":"
      + request.getServerPort() + path + "/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">

    <title>jQuery Validate验证框架详解-metadata用法</title>

    <meta http-equiv="pragma" content="no-cache">
    <meta http-equiv="cache-control" content="no-cache">
    <meta http-equiv="expires" content="0">
    <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
    <meta http-equiv="description" content="This is my page">
    <script type="text/javascript" src="<%=request.getContextPath()%>/validate/jquery-1.6.2.min.js"></script>
    <script type="text/javascript" src="<%=request.getContextPath()%>/validate/jquery.validate.min.js"></script>
    <script type="text/javascript" src="<%=request.getContextPath()%>/validate/jquery.metadata.min.js"></script>
    <script type="text/javascript" src="<%=request.getContextPath()%>/validate/messages_zh.js"></script>
    <script type="text/javascript">
    $(function(){
      $("#myform").validate();
    });
    </script>
  </head>

  <body>
    <form id="myform" method="post" action="">
      <p>
        <label for="myname">用户名:</label>
        <!-- id和name最好同时写上 -->
        <input id="myname" name="myname" class="required" />
      </p>
      <p>
        <label for="email">E-Mail:</label>
        <input id="email" name="email" class="required email" />
      </p>
      <p>
        <label for="password">登陆密码:</label>
        <input id="password" name="password" type="password"
          class="{required:true,minlength:5}" />
      </p>
      <p>
        <label for="confirm_password">确认密码:</label>
        <input id="confirm_password" name="confirm_password" type="password"
          class="{required:true,minlength:5,equalTo:'#password'}" />
      </p>
      <p>
        <label for="confirm_password">性别:</label>
        <!-- 表示必须选中一个 -->
        <input type="radio" id="gender_male" value="m" name="gender" class="{required:true}" />
        <input type="radio" id="gender_female" value="f" name="gender"/>
      </p>
      <p>
        <label for="confirm_password">爱好:</label>
        <!-- checkbox的minlength表示必须选中的最小个数,maxlength表示最大的选中个数,rangelength:[2,3]表示选中个数区间 -->
        <input type="checkbox" id="spam_email" value="email" name="spam[]" class="{required:true, minlength:2}" />
        <input type="checkbox" id="spam_phone" value="phone" name="spam[]" />
        <input type="checkbox" id="spam_mail" value="mail" name="spam[]" />
      </p>
      <p>
        <label for="confirm_password">城市:</label>
        <select id="jungle" name="jungle" title="Please select something!" class="{required:true}">
          <option value=""></option>
          <option value="1">厦门</option>
          <option value="2">泉州</option>
        <option value="3">Oi</option>
      </select>
      </p>
      <p>
        <input class="submit" type="submit" value="立即注册" />
      </p>
    </form>
  </body>
</html>

使用class="{}"的方式,必须引入包:jquery.metadata.js;

可以使用如下的方法,修改提示内容:

class="{required:true,minlength:5,messages:{required:'请输入内容'}}";

在使用equalTo关键字时,后面的内容必须加上引号,如下代码:

class="{required:true,minlength:5,equalTo:'#password'}"

2、将校验规则写到js代码中

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
  String path = request.getContextPath();
  String basePath = request.getScheme() + "://" + request.getServerName() + ":"
      + request.getServerPort() + path + "/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">

    <title>jQuery Validate验证框架详解</title>

    <meta http-equiv="pragma" content="no-cache">
    <meta http-equiv="cache-control" content="no-cache">
    <meta http-equiv="expires" content="0">
    <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
    <meta http-equiv="description" content="This is my page">
    <script type="text/javascript" src="<%=request.getContextPath()%>/validate/jquery-1.6.2.min.js"></script>
    <script type="text/javascript" src="<%=request.getContextPath()%>/validate/jquery.validate.min.js"></script>
    <script type="text/javascript">
    $(function(){
      var validate = $("#myform").validate({
        debug: true, //调试模式取消submit的默认提交功能  
        //errorClass: "label.error", //默认为错误的样式类为:error  
        focusInvalid: false, //当为false时,验证无效时,没有焦点响应 
        onkeyup: false,  
        submitHandler: function(form){  //表单提交句柄,为一回调函数,带一个参数:form  
          alert("提交表单");  
          form.submit();  //提交表单  
        },  
        
        rules:{
          myname:{
            required:true
          },
          email:{
            required:true,
            email:true
          },
          password:{
            required:true,
            rangelength:[3,10]
          },
          confirm_password:{
            equalTo:"#password"
          }          
        },
        messages:{
          myname:{
            required:"必填"
          },
          email:{
            required:"必填",
            email:"E-Mail格式不正确"
          },
          password:{
            required: "不能为空",
            rangelength: $.format("密码最小长度:{0}, 最大长度:{1}。")
          },
          confirm_password:{
            equalTo:"两次密码输入不一致"
          }                  
        }
             
      });  
  
    });
    </script>
  </head>

  <body>
    <form id="myform" method="post" action="">
      <p>
        <label for="myname">用户名:</label>
        <!-- id和name最好同时写上 -->
        <input id="myname" name="myname" />
      </p>
      <p>
        <label for="email">E-Mail:</label>
        <input id="email" name="email" />
      </p>
      <p>
        <label for="password">登陆密码:</label>
        <input id="password" name="password" type="password" />
      </p>
      <p>
        <label for="confirm_password">确认密码:</label>
        <input id="confirm_password" name="confirm_password" type="password" />
      </p>
      <p>
        <input class="submit" type="submit" value="立即注册" />
      </p>
    </form>
  </body>
</html>

五、常用方法及注意问题

1、用其他方式替代默认的submit

$(function(){
  $("#signupForm").validate({
    submitHandler:function(form){
      alert("submit!");  
      form.submit();
    }  
  });
});

可以设置validate的默认值,写法如下:

$.validator.setDefaults({
 submitHandler: function(form) { alert("submit!"); form.submit(); }
});

如果想提交表单,需要使用form.submit(),而不要使用$(form).submit()

2、debug,只验证不提交表单

如果这个参数为true,那么表单不会提交,只进行检查,调试时十分方便

$(function(){
  $("#signupForm").validate({
    debug:true
  });
});

如果一个页面中有多个表单都想设置成为debug,用

$.validator.setDefaults({
 debug: true
})

3、ignore:忽略某些元素不验证

ignore: ".ignore"

4、更改错误信息显示的位置

errorPlacement:Callback

Default: 把错误信息放在验证的元素后面指明错误放置的位置,默认情况是:error.appendTo(element.parent());即把错误信息放在验证的元素后面

errorPlacement: function(error, element) { 
   error.appendTo(element.parent()); 
}
//示例

<tr>
  <td class="label"><label id="lfirstname" for="firstname">First Name</label></td>
  <td class="field"><input id="firstname" name="firstname" type="text" value="" maxlength="100" /></td>
  <td class="status"></td>
</tr>
<tr>
  <td style="padding-right: 5px;">
    <input id="dateformat_eu" name="dateformat" type="radio" value="0" />
    <label id="ldateformat_eu" for="dateformat_eu">14/02/07</label>
  </td>
  <td style="padding-left: 5px;">
    <input id="dateformat_am" name="dateformat" type="radio" value="1" />
    <label id="ldateformat_am" for="dateformat_am">02/14/07</label>
  </td>
  <td></td>
</tr>
<tr>
  <td class="label">&nbsp;</td>
  <td class="field" colspan="2">
    <div id="termswrap">
      <input id="terms" type="checkbox" name="terms" />
      <label id="lterms" for="terms">I have read and accept the Terms of Use.</label>
    </div>
  </td>
</tr>

errorPlacement: function(error, element) {
  if (element.is(":radio"))
    error.appendTo(element.parent().next().next());
  else if (element.is(":checkbox"))
    error.appendTo(element.next());
  else
    error.appendTo(element.parent().next());
}

代码的作用是:一般情况下把错误信息显示在<td class="status"></td>中,如果是radio显示在<td></td>中,如果是checkbox显示在内容的后面

errorClass:String Default: "error" 指定错误提示的css类名,可以自定义错误提示的样式

errorElement:String Default: "label" 用什么标签标记错误,默认的是label你可以改成em

errorContainer:Selector 显示或者隐藏验证信息,可以自动实现有错误信息出现时把容器属性变为显示,无错误时隐藏,用处不大

errorContainer: "#messageBox1, #messageBox2"

errorLabelContainer:Selector

把错误信息统一放在一个容器里面。

wrapper:String

用什么标签再把上边的errorELement包起来

一般这三个属性同时使用,实现在一个容器内显示所有错误提示的功能,并且没有信息时自动隐藏

errorContainer: "div.error",
errorLabelContainer: $("#signupForm div.error"),
wrapper: "li"

5、更改错误信息显示的样式

设置错误提示的样式,可以增加图标显示,在该系统中已经建立了一个validation.css专门用于维护校验文件的样式

input.error { border: 1px solid red; }
label.error {
  background:url("./demo/images/unchecked.gif") no-repeat 0px 0px;
  padding-left: 16px;
  padding-bottom: 2px;
  font-weight: bold;
  color: #EA5200;
}
label.checked {
  background:url("./demo/images/checked.gif") no-repeat 0px 0px;
}

6、每个字段验证通过执行函数

success:String,Callback 要验证的元素通过验证后的动作,如果跟一个字符串,会当做一个css类,也可跟一个函数

success: function(label) {
  // set &nbsp; as text for IE
  label.html("&nbsp;").addClass("checked");
  //label.addClass("valid").text("Ok!")
}

添加"valid"到验证元素, 在CSS中定义的样式<style>label.valid {}</style> success: "valid"

7、验证的触发方式修改

下面的虽然是boolean型的,但建议除非要改为false,否则别乱添加。

a.onsubmit:Boolean Default: true 提交时验证. 设置唯false就用其他方法去验证

b.onfocusout:Boolean Default: true 失去焦点是验证(不包括checkboxes/radio buttons)

c.onkeyup:Boolean Default: true 在keyup时验证.

d.onclick:Boolean Default: true 在checkboxes 和 radio 点击时验证

e.focusInvalid:Boolean Default: true 提交表单后,未通过验证的表单(第一个或提交之前获得焦点的未通过验证的表单)会获得焦点

f.focusCleanup:Boolean Default: false 如果是true那么当未通过验证的元素获得焦点时,移除错误提示。避免和focusInvalid一起用

8、异步验证

remote:URL

使用ajax方式进行验证,默认会提交当前验证的值到远程地址,如果需要提交其他的值,可以使用data选项

示例一:

remote: "check-email.php"

示例二:

remote: {
  url: "check-email.php",   //后台处理程序
  type: "post",        //数据发送方式
  dataType: "json",      //接受数据格式  
  data: {           //要传递的数据
    username: function() {
      return $("#username").val();
    }
  }
}

远程地址只能输出"true"或"false",不能有其它输出。

9、添加自定义校验

addMethod:name, method, message

自定义验证方法

// 中文字两个字节
jQuery.validator.addMethod(
  "byteRangeLength", 
  function(value, element, param) {
    var length = value.length;
    for(var i = 0; i < value.length; i++){
      if(value.charCodeAt(i) > 127){
        length++;
      }
    }
    return this.optional(element) || (length >= param[0] && length <= param[1]);  
  }, 
  $.validator.format("请确保输入的值在{0}-{1}个字节之间(一个中文字算2个字节)")
);

// 邮政编码验证  
jQuery.validator.addMethod("isZipCode", function(value, element) {  
  var tel = /^[0-9]{6}$/;
  return this.optional(element) || (tel.test(value));
}, "请正确填写您的邮政编码");

1.要在additional-methods.js文件中添加或者在jquery.validate.js添加建议一般写在additional-methods.js文件中

2.在messages_cn.js文件添加:isZipCode: "只能包括中文字、英文字母、数字和下划线",调用前要添加对additional-methods.js文件的引用。

10、radio和checkbox、select的验证

1.radio的required表示必须选中一个

<input type="radio" id="gender_male" value="m" name="gender" class="{required:true}" />
<input type="radio" id="gender_female" value="f" name="gender"/>

2.checkbox的required表示必须选中

<input type="checkbox" class="checkbox" id="agree" name="agree" class="{required:true}" />

checkbox的minlength表示必须选中的最小个数,maxlength表示最大的选中个数,rangelength:[2,3]表示选中个数区间

<input type="checkbox" id="spam_email" value="email" name="spam[]" class="{required:true, minlength:2}" />
<input type="checkbox" id="spam_phone" value="phone" name="spam[]" />
<input type="checkbox" id="spam_mail" value="mail" name="spam[]" />

3.select的required表示选中的value不能为空

<select id="jungle" name="jungle" title="Please select something!" class="{required:true}">
  <option value=""></option>
  <option value="1">Buga</option>
  <option value="2">Baga</option>
  <option value="3">Oi</option>
</select>

select的minlength表示选中的最小个数(可多选的select),maxlength表示最大的选中个 数,rangelength:[2,3]表示选中个数区间

<select id="fruit" name="fruit" title="Please select at least two fruits" class="{required:true, minlength:2}" multiple="multiple">
  <option value="b">Banana</option>
  <option value="a">Apple</option>
  <option value="p">Peach</option>
  <option value="t">Turtle</option>
</select>

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# jQuery  # Validate  # 验证 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: javascript中的数组方法有哪些_如何利用数组方法简化数据处理  Laravel如何创建自定义Artisan命令?(代码示例)  Laravel如何使用Blade组件和插槽?(Component代码示例)  阿里云网站搭建费用解析:服务器价格与建站成本优化指南  laravel怎么配置Redis作为缓存驱动_laravel Redis缓存配置教程  关于BootStrap modal 在IOS9中不能弹出的解决方法(IOS 9 bootstrap modal ios 9 noticework)  郑州企业网站制作公司,郑州招聘网站有哪些?  齐河建站公司:营销型网站建设与SEO优化双核驱动策略  C#如何调用原生C++ COM对象详解  如何使用 jQuery 正确渲染 Instagram 风格的标签列表  Python正则表达式进阶教程_复杂匹配与分组替换解析  Laravel怎么多语言本地化设置_Laravel语言包翻译与Locale动态切换【手册】  Laravel如何连接多个数据库_Laravel多数据库连接配置与切换教程  公司门户网站制作公司有哪些,怎样使用wordpress制作一个企业网站?  韩国网站服务器搭建指南:VPS选购、域名解析与DNS配置推荐  bootstrap日历插件datetimepicker使用方法  如何注册花生壳免费域名并搭建个人网站?  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  Python自动化办公教程_ExcelWordPDF批量处理案例  微博html5版本怎么弄发语音微博_语音录制入口及时长限制操作【教程】  简单实现Android文件上传  javascript中的try catch异常捕获机制用法分析  laravel怎么在请求结束后执行任务(Terminable Middleware)_laravel Terminable Middleware请求结束任务执行方法  EditPlus中的正则表达式 实战(1)  javascript如何操作浏览器历史记录_怎样实现无刷新导航  详解阿里云nginx服务器多站点的配置  怎么制作网站设计模板图片,有电商商品详情页面的免费模板素材网站推荐吗?  Laravel如何发送系统通知_Laravel Notifications实现多渠道消息通知  JavaScript模板引擎Template.js使用详解  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  Laravel怎么实现模型属性转换Casting_Laravel自动将JSON字段转为数组【技巧】  如何在阿里云部署织梦网站?  如何确保西部建站助手FTP传输的安全性?  Laravel如何实现邮件验证激活账户_Laravel内置MustVerifyEmail接口配置【步骤】  PythonWeb开发入门教程_Flask快速构建Web应用  如何实现javascript表单验证_正则表达式有哪些实用技巧  使用豆包 AI 辅助进行简单网页 HTML 结构设计  中国移动官方网站首页入口 中国移动官网网页登录  高配服务器限时抢购:企业级配置与回收服务一站式优惠方案  Laravel如何实现邮箱地址验证功能_Laravel邮件验证流程与配置  Laravel Eloquent:优雅地将关联模型字段扁平化到主模型中  Laravel Asset编译怎么配置_Laravel Vite前端构建工具使用  音乐网站服务器如何优化API响应速度?  为什么要用作用域操作符_php中访问类常量与静态属性的优势【解答】  Laravel如何生成API文档?(Swagger/OpenAPI教程)  jimdo怎样用html5做选项卡_jimdo选项卡html5实现与切换效果【指南】  手机怎么制作网站教程步骤,手机怎么做自己的网页链接?  Laravel如何从数据库删除数据_Laravel destroy和delete方法区别  Laravel用户密码怎么加密_Laravel Hash门面使用教程  JavaScript Ajax实现异步通信