jquery.数据验证
jquery. 数据验证
一、准备工作
需要JQuery 版本：1.2.6+, 兼容 1.3.2
按需求添加自定义消息提示
二、默认校验规则
(1)required:true 必输字段
(2)remote:"check.php" 使用ajax 方法调用check.php 验证输入值
(3)email:true 必须输入正确格式的电子邮件
(4)url:true 必须输入正确格式的网址
(5)date:true 必须输入正确格式的日期
(6)dateISO:true 必须输入正确格式的日期(ISO)，例如：2009-06-23，1998/01/22 只验证格式，不验证有效性
(7)number:true 必须输入合法的数字(负数，小数)
(8)digits:true 必须输入整数
(9)creditcard: 必须输入合法的信用卡号
(10)equalTo:"#field" 输入值必须和#field相同
(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 方法可以将默认校验方法的提示信息，改为自定义内容
jQuery.extend(jQuery.validator.messages, {
required: "必选字段",
remote: "请修正该字段",
email: "请输入正确格式的电子邮件",
url: "请输入合法的网址",
date: "请输入合法的日期",
dateISO: "请输入合法的日期 (ISO).",
number: "请输入合法的数字",
digits: "只能输入整数",
creditcard: "请输入合法的信用卡号",
equalTo: "请再次输入相同的值",
accept: "请输入拥有合法后缀名的字符串",
maxlength: jQuery.validator.format("请输入一个长度最多是 {0} 的字符串"), minlength: jQuery.validator.format("请输入一个长度最少是 {0} 的字符串"),
rangelength: jQuery.validator.format("请输入一个长度介于 {0} 和 {1} 之间的字符串"),
range: jQuery.validator.format("请输入一个介于 {0} 和 {1} 之间的值"),
max: jQuery.validator.format("请输入一个最大为 {0} 的值"),
min: jQuery.validator.format("请输入一个最小为 {0} 的值")
});
然后保存成JS 文件例如：messages_cn.js
页面中引入:
会替换jquery.validate.js 中的messages 方法
四、使用方式 1. 将校验规则写到控件中
$().ready(function() {
$("#signupForm").validate();
});
使用class="{}"的方式，必须引入包：jquery.metadata.js
可以使用如下的方法，修改提示内容：
class="{required:true,minlength:5,messages:{required:'请输入内容'}}"
在使用equalTo 关键字时，后面的内容必须加上引号，如下代码：
class="{required:true,minlength:5,equalTo:'#password'}"
另外一个方式，使用关键字：meta （为了元数据使用其他插件你要包装你的验证规则在他们自己的项目中可以用这个特殊的选项）例如：
meta: "validate"
class="{validate:{required:true,minlength:5}}" />
2. 将验证规则写成属性
$.metadata.setType("attr", "validate");
这样可以使用validate="{required:true}"的方式，或者class="required"，但
class="{required:true,minlength:5}"将不起作用
3. 将校验规则写到代码中
$().ready(function() {
$("#signupForm").validate({
rules: {
firstname: "required",
email: {
required: true,
email: true
},
password: {
required: true,
minlength: 5
},
confirm_password: {
required: true,
minlength: 5,
equalTo: "#password"
}
},
messages: {
firstname: "请输入姓名",
email: {
required: "请输入Email 地址",
email: "请输入正确的email 地址"
},
password: {
required: "请输入密码",
minlength: jQuery.format("密码不能小于{0}个字符")
},
confirm_password: {
required: "请输入确认密码",
minlength: "确认密码不能小于5个字符",
equalTo: "两次输入密码不一致不一致"
}
}
});
});
//messages处，如果某个控件没有message ，将调用默认的信息
required:true必须有值
required:"#aa:checked"表达式的值为真，则需要验证
required:function(){}返回为真，表时需要验证
后边两种常用于，表单中需要同时填或不填的元素
五、常用方法及注意事项
1. 用其他方式替代默认的submit
$().ready(function() {
$("#signupForm").validate({
submitHandler:function(form){
alert("submitted");
form.submit();
}
});
});
可以设置validate 的默认值，写法如下：
$.validator.setDefaults({
submitHandler: function(form) { alert("submitted!");form.submit(); }
});
如果想提交表单, 需要使用form.submit()而不要使用$(form).submit()
2.debug ，如果这个参数为true ，那么表单不会提交，只进行检查，调试时十分方便
$().ready(function() {
$("#signupForm").validate({
debug:true
});
});
如果一个页面中有多个表单，用
$.validator.setDefaults({
debug: true
})
3.ignore ：忽略某些元素不验证
ignore: ".ignore"
4.errorPlacement ：Callback Default: 把错误信息放在验证的元素后面
指明错误放置的位置，默认情况是：error.appendTo(element.parent());即把错误信息放在验证的元素后面
errorPlacement: function(error, element) {
error.appendTo(element.parent());
}
//示例：
/>
14/02/07
02/14/07
I have read and accept the Terms of Use.
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() );
}
代码的作用是：一般情况下把错误信息显示在
中，如果是radio 显示在
中，如果是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: $("#signupFormdiv.error"),
wrapper: "li"
5. 设置错误提示的样式，可以增加图标显示
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: function(label) {
label.html(" ").addClass("checked");
}
添加"valid" 到验证元素, 在CSS 中定义的样式
success: "valid"
7. 验证事件
nsubmit ： Boolean Default: true
提交时验证. 设置唯false 就用其他方法去验证
onfocusout ：Boolean Default: true
失去焦点是验证(不包括checkboxes/radio buttons)
onkeyup ：Boolean Default: true
在keyup 时验证.
onclick ：Boolean Default: true
在checkboxes 和 radio 点击时验证
focusInvalid ：Boolean Default: true
提交表单后，未通过验证的表单(第一个或提交之前获得焦点的未通过验证的表单) 会获得焦点 focusCleanup ：Boolean Default: false
如果是true 那么当未通过验证的元素获得焦点时，移除错误提示。避免和focusInvalid 一起用
8. 重置表单
$().ready(function() {
var validator = $("#signupForm").validate({ submitHandler:function(form){
alert("submitted");
form.submit();
}
});
$("#reset").click(function() {
validator.resetForm();
});
});
9.