jquery.validate.js最新 最新下载地址
http://bassistance.de/jquery-plugins/jquery-plugin-validation/
注意:如果要启用键盘或者是鼠标事件:
则要在验证方法中添加:【onfocusout:function(element) {$(element).valid()},】这个是启用当前点击input的。如果为【onfocusout:true,】则是启用所有每个input验证。
一导入js库
<script src="../js/jquery.js" type="text/javascript"></script>
<script src="../js/jquery.validate.js" type="text/javascript"></script>
二、默认校验规则
(1)required:true 必输字段
(2)remote:"check.php" 使用ajax方法调用check.php验证输入值
(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: 必须输入合法的信用卡号
(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: {
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代码中加入:
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} 的值")
});
推荐做法,将此文件放入messages_cn.js中,在页面中引入
<script src="../js/messages_cn.js" type="text/javascript"></script>
四、使用方式
1.将校验规则写到控件中
<script src="../js/jquery.js" type="text/javascript"></script>
<script src="../js/jquery.validate.js" type="text/javascript"></script>
<script src="./js/jquery.metadata.js" type="text/javascript"></script>
$().ready(function() {
$("#signupForm").validate();
});
<form id="signupForm" method="get" action="">
<p>
<label for="firstname">Firstname</label>
<input id="firstname" name="firstname" class="required" />
</p>
<p>
<label for="email">E-Mail</label>
<input id="email" name="email" class="required email" />
</p>
<p>
<label for="password">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>
<input class="submit" type="submit" value="Submit"/>
</p>
</form>
使用class="{}"的方式,必须引入包:jquery.metadata.js
可以使用如下的方法,修改提示内容:
class="{required:true,minlength:5,messages:{required:'请输入内容'}}"
在使用equalTo关键字时,后面的内容必须加上引号,如下代码:
class="{required:true,minlength:5,equalTo:'#password'}"
2.将校验规则写到js代码中
$().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,将调用默认的信息
<form id="signupForm" method="get" action="">
<p>
<label for="firstname">Firstname</label>
<input id="firstname" name="firstname" />
</p>
<p>
<label for="email">E-Mail</label>
<input id="email" name="email" />
</p>
<p>
<label for="password">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="Submit"/>
</p>
</form>
required:true 必须有值
required:"#aa:checked"表达式的值为真,则需要验证
required:function(){}返回为真,表时需要验证
后边两种常用于,表单中需要同时填或不填的元素
五、常用方法及注意问题
1.用其他方式替代默认的SUBMIT
$().ready(function() {
$("#signupForm").validate({
submitHandler:function(form){
alert("submitted");
form.submit();
}
});
});
使用ajax方式
$(".selector").validate({
submitHandler: function(form)
{
$(form).ajaxSubmit();
}
})
可以设置validate的默认值,写法如下:
$.validator.setDefaults({
submitHandler: function(form) { alert("submitted!");form.submit(); }
});
如果想提交表单, 需要使用form.submit()而不要使用$(form).submit()
2.debug,只验证不提交表单
如果这个参数为true,那么表单不会提交,只进行检查,调试时十分方便
$().ready(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"> </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></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 as text for IE
label.html(" ").addClass("checked");
//label.addClass("valid").text("Ok!")
}
添加"valid" 到验证元素, 在CSS中定义的样式<style>label.valid {}</style>
success: "valid"
7验证的触发方式修改
下面的虽然是boolean型的,但建议除非要改为false,否则别乱添加。
onsubmit: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 一起用
// 重置表单
$().ready(function() {
var validator = $("#signupForm").validate({
submitHandler:function(form){
alert("submitted");
form.submit();
}
});
$("#reset").click(function() {
validator.resetForm();
});
});
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文件的引用。
10radio和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" 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 中文API
名称 |
返回类型 |
描述 |
validate(options) |
返回:Validator |
验证所选的FORM |
valid() |
返回:Boolean |
检查是否验证通过 |
rules() |
返回:Options |
返回元素的验证规则 |
rules("add",rules) |
返回:Options |
增加验证规则 |
rules("remove",rules) |
返回:Options |
删除验证规则 |
removeAttrs(attributes) |
返回:Options |
删除特殊属性并且返回他们 |
Custom selectors |
||
:blank |
返回:Validator |
没有值的筛选器 |
:filled |
返回:Array <Element |
有值的筛选器 |
:unchecked |
返回:Array <Element |
没选择的元素的筛选器 |
Utilities |
||
jQuery.format (template,argument |
返回:String |
用参数代替模板中的 |
Validator: |
||
validate方法返回一个Validator对象,它有很多方法,让你能使用引发校验程序或者改变form的内容. validator对象有很多方法,但下面只是列出常用的 |
||
form() |
返回:Boolean |
验证form返回成功还是失败 |
element(element) |
返回:Boolean |
验证单个元素是成功还是失败 |
resetForm() |
返回:undefined |
把前面验证的FORM恢复到验证前原来的状态 |
showErrors(errors) |
返回:undefined |
显示特定的错误信息 |
Validator functions: |
||
setDefaults(defaults) |
返回:undefined |
改变默认的设置 |
addMethod(name,method,message) |
返回:undefined |
添加一个新的验证方法.必须包括一个独一无二的名字,一个JAVASCRIPT的方法和一个默认的信息 |
addClassRules(name,rules) |
返回:undefined |
增加组合验证类型 在一个类里面用多种验证方法里比较有用 |
addClassRules(rules) |
返回:undefined |
增加组合验证类型 在一个类里面用多种验证方法里比较有用,这个是一下子加多个 |
内置验证方式: |
||
required() |
返回:Boolean |
必填验证元素 |
required(dependency-expression) |
返回:Boolean |
必填元素依赖于表达式的结果 |
required(dependency-callback) |
返回:Boolean |
必填元素依赖于回调函数的结果 |
remote(url) |
返回:Boolean |
请求远程校验。url通常是一个远程调用方法 |
minlength(length) |
返回:Boolean |
设置最小长度 |
maxlength(length) |
返回:Boolean |
设置最大长度 |
rangelength(range) |
返回:Boolean |
设置一个长度范围[min,max] |
min(value) |
返回:Boolean |
设置最大值 |
max(value) |
返回:Boolean |
设置最小值 |
email() |
返回:Boolean |
验证电子邮箱格式 |
range(range) |
返回:Boolean |
设置值的范围 |
url() |
返回:Boolean |
验证URL格式 |
date() |
返回:Boolean |
验证日期格式(类似30/30/2008的格式,不验证日期准确性只验证格式) |
dateISO() |
返回:Boolean |
验证ISO类型的日期格式 |
dateDE() |
返回:Boolean |
验证德式的日期格式(29.04.1994 or |
number() |
返回:Boolean |
验证十进制数字(包括小数的) |
digits() |
返回:Boolean |
验证整数 |
creditcard() |
返回:Boolean |
验证信用卡号 |
accept(extension) |
返回:Boolean |
验证相同后缀名的字符串 |
equalTo(other) |
返回:Boolean |
验证两个输入框的内容是否相同 |
phoneUS() |
返回:Boolean |
验证美式的电话号码 |
validate ()的可选项: |
|
debug:进行调试模式(表单不提交): |
$(".selector").validate ({ debug:true }) |
把调试设置为默认: |
$.validator.setDefaults({ debug:true }) |
submitHandler: 通过验证后运行的函数,里面要加上表单提交的函数,否则表单不会提交 |
$(".selector").validate({ submitHandler:function(form) $(form).ajaxSubmit(); } }) |
ignore: 对某些元素不进行验证 |
$("#myform").validate({ ignore:".ignore" }) |
rules: 自定义规则,key:value的形式,key是要验证的元素,value可以是字符串或对象 |
$(".selector").validate({ rules:{ name:"required", email:{ required:true, email:true } } }) |
messages: 自定义的提示信息key:value的形式key是要验证的元素,值是字符串或函数 |
$(".selector").validate({ rules:{ name:"required", email:{ required:true, email:true } }, messages:{ name:"Name不能为空", email:{ email:"E-mail地址不正确" } } }) |
groups: 对一组元素的验证,用一个错误提示,用error Placement控制把出错信息放在哪里 |
$("#myform").validate({ groups:{ username:"fname }, if (element.attr("name") == else }, debug:true }) |
Onubmit Boolean默认:true 是否提交时验证 |
$(".selector").validate({ }) |
onfocusout Boolean默认:true 是否在获取焦点时验证 |
$(".selector").validate({ }) |
onkeyup Boolean默认:true 是否在敲击键盘时验证 |
$(".selector").validate({ onkeyup:false }) |
onclick Boolean默认:true 是否在鼠标点击时验证(一般验证checkbox,radiobox) |
$(".selector").validate({ onclick:false }) |
focusInvalid Boolean默认:true 提交表单后,未通过验证的表单(第一个或提交之前获得焦点的未通过验证的表单)会获得焦点 |
$(".selector").validate({ focusInvalid:false }) |
focusCleanup Boolean默认:false 当未通过验证的元素获得焦点时,并移除错误提示(避免和 focusInvalid.一起使用) |
$(".selector").validate({ focusCleanup:true }) |
errorClass String默认:"error" 指定错误提示的css类名,可以自定义错误提示的样式 |
$(".selector").validate({ }) |
errorElement String默认:"label" 使用什么标签标记错误 |
$(".selector").validate errorElement:"em" }) |
wrapper String 使用什么标签再把上边的errorELement包起来 |
$(".selector").validate({ wrapper:"li" }) |
errorLabelContainer Selector 把错误信息统一放在一个容器里面 |
$("#myform").validate({ wrapper:"li", submitHandler:function() { }) |
showErrors: 跟一个函数,可以显示总共有多少个未通过验证的元素 |
$(".selector").validate({ $("#summary").html("Your } }) |
errorPlacement: 跟一个函数,可以自定义错误放到哪里 |
$("#myform").validate({ }, debug:true }) |
success: 要验证的元素通过验证后的动作,如果跟一个字符串,会当做一个css类,也可跟一个函数 |
$("#myform").validate({ submitHandler:function() }) |
highlight: 可以给未通过验证的元素加效果,闪烁等 |
addMethod(name,method,message)方法: |
参数name是添加的方法的名字 |
参数method是一个函数,接收三个参数(value,element,param) $.validator.addMethod("af",function(value,element,params){ return false; } if(value>=params[0] return true; }else{ return false; } },"必须是一个字母,且a-f"); 用的时候,比如有个表单字段的id="username",则在rules中写 username:{ af:["a","f"] } addMethod的第一个参数,就是添加的验证方法的名子,这时是af addMethod的第三个参数,就是自定义的错误提示,这里的提示为:"必须是一个字母,且a-f" addMethod的第二个参数,是一个函数,这个比较重要,决定了用这个验证方法时的写法 如果只有一个参数,直接写,如果af:"a",那么a就是这个唯一的参数,如果多个参数,用在[]里,用逗号分开 |
meta String方式: |
$("#myform").validate({
meta:"validate",
submitHandler:function() {
}) |
<script type="text/javascript"
<script type="text/javascript"
<form id="myform">
<input type="text"
<input type="submit"
</form> |
Html代码
<script type="text/javascript" src="js/jquery-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><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 id="commentForm" method="get" action="">
Name<input id="cname" name="name" size="25" minlength="2" />
<input type="submit" value="Submit"/>
</form>
此文谨以以上js片段开始介绍jQuery Validation。
验证从这个方法开始:validate( [options] )
(一)、可选项( 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 [email protected]"
}
}
})
$(".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 [email protected]"
}
}
})
[7] groups 类型:Options
说明:指定错误消息分组。一个组由一个任意的组名作为键,一个由空白符分割的表单元素name属性列表作为值。用errorPlacement定义组消息的存放位置。
Js代码
$("#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
})
$("#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代码
$(".selector").validate({
onsubmit: false
})
$(".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
})
原文地址:http://docs.jquery.com/Plugins/Validation/validate#toptions
(二)插件方法 (jQuery validation)
文章分类:Web前端
[1] validate( [options] ) 返回:Validator
说明:见第一部分 [2] valid() 返回:Boolean
说明:检查表单是否已通过验证。
$("#myform").validate();
$("a.check").click(function() {
alert("Valid: " + $("#myform").valid());
return false;
});
$("#myform").validate();
$("a.check").click(function() {
alert("Valid: " + $("#myform").valid());
return false;
});
[3] rules() 返回:Options
说明:返回一个表单元素的验证规则。有几个方法定义验证规则:
在表单元素的class属性中定义验证规则(推荐的方法)。
通过指定验证方法的属性(推荐的方法)。
可以通过元数据(metadata)插件来定义元数据验证规则。
可以通过指定validate()方法的rules选项。
alert($("#password").rules()["required"]);
alert($("#password").rules()["required"]);
[4] rules( "add", rules ) 返回:Options
参数"add" 类型:String
参数 rules 类型:Options 要添加的规则,与validate方法中的验证规则一致。
说明:添加规则到匹配的表单元素,返回该元素的所有验证规则,需要先执行$("form").validate()。在rules中也可以添加用户自定义的消息对象。
$("#myinput").rules("add", {
required: true,
minlength: 2,
messages: {
required: "Required input",
minlength: jQuery.format("Please, at least {0} characters are necessary")
}
});
$("#myinput").rules("add", {
required: true,
minlength: 2,
messages: {
required: "Required input",
minlength: jQuery.format("Please, at least {0} characters are necessary")
}
});
[5] rules( "remove", [rules] ) 返回:Options
参数"remove" 类型:String
参数 rules (Options) 类型:Options 用空白符分割的验证规则。只操作通过rules选项或rules("add")指定的验证规则。
说明:从第一个匹配的表单元素中移除指定的验证规则,并返回该元素所有的验证规则。
$("#myinput").rules("remove");
$("#myinput").rules("remove", "min max");
$("#myinput").rules("remove");
$("#myinput").rules("remove", "min max");
[6] removeAttrs( attributes ) 返回:Options
参数 attributes 类型:String 用空白符分割的属性列表
说明:从第一个匹配的表单元素中删除指定的属性并返回它们。
$("#skip").click(function() {
var rules = $("#myinput").removeAttrs("min max");
$("#myform).submit();
$("#myinput").attr(rules);
});
$("#skip").click(function() {
var rules = $("#myinput").removeAttrs("min max");
$("#myform).submit();
$("#myinput").attr(rules);
});
原文请见:http://docs.jquery.com/Plugins/Validation#Fields_with_complex_names_.28brackets.2C_dots.29
(三、四)选择器及实用工具 (jQuery validation)
文章分类:Web前端
[1] :blank 返回:Array<Element>
说明:匹配所有空值的表单元素。没有任何值或都空白符(whitespace)都被认为是空值。
它是由 jQuery.trim(value).length == 0 来判断的。
$("input:blank").css("background-color", "#bbbbff");
$("input:blank").css("background-color", "#bbbbff");
[2] :filled 返回:Array<Element>
说明:匹配所有不为空的表单元素。任何值都可以认为是已输入的,但只有空白符的值除外。
它是由 jQuery.trim(value).length > 0 来判断的。
$("input:filled").css("background-color", "#bbbbff");
$("input:filled").css("background-color", "#bbbbff");
[3] :unchecked 返回:Array<Element>
说明:匹配所有未选择的表单元素。反向操作为 :checked
function countUnchecked() {
var n = $("input:unchecked").length;
$("div").text(n + (n == 1 ? " is" : " are") + " unchecked!");
}
countUnchecked();
$(":checkbox").click(countUnchecked);
function countUnchecked() {
var n = $("input:unchecked").length;
$("div").text(n + (n == 1 ? " is" : " are") + " unchecked!");
}
countUnchecked();
$(":checkbox").click(countUnchecked);
四、实用工具(Utilities)
jQuery.validator.format( template, [argument], [argumentN...] ) 返回:String
参数 template 类型:String 要格式化的字符串
参数 argument (Optional) 类型:String, Array<String> 用字符串或字符串数组(对应索引的元素)填充第一个占位符
参数 argumentN... (Optional) 类型:String 填充第二个或之后的占位符。
说明:用参数来填充{n}占位符。除template外的一个或多个参数都可以用来填充相应的占位符。
$(document).ready(function(){
$("button").click(function () {
var str = "Hello {0}, this is {1}";
alert("'" + str + "'");
str = jQuery.validator.format(str, "World", "Bob");
//str = $.validator.format(str, ["koala","oo"]);
alert("'" + str + "'");
});
});
$(document).ready(function(){
$("button").click(function () {
var str = "Hello {0}, this is {1}";
alert("'" + str + "'");
str = jQuery.validator.format(str, "World", "Bob");
//str = $.validator.format(str, ["koala","oo"]);
alert("'" + str + "'");
});
});
原文请见:http://docs.jquery.com/Plugins/Validation
(五)验证器 (jQuery validation)
validate方法返回的验证器对象( Validator Object) 有一些公用的方法。你可以用来触发验证程序或改变表单(form)的内容。验证器对象有更多的方法,不过只有文档中给出的这些方法是专为使用而设计的。 (一)验证器方法(Validator methods)
[1] form() 返回:Boolean
说明:验证表单是否通过验证,若通过验证则返回true,反之返回false。这个方法在正常的提交事件(submit event)触发,它返回一个结果。
$("#myform").validate().form();
$("#myform").validate().form();
[2] element( element ) 返回:Boolean
参数 element 类型:Selector 验证表单中的一个需要验证的表单元素。
说明:验证单个表单元素是否通过验证,若通过验证则返回true,反之返回false。这个方法在正常的焦点离开事件(blur)或按键弹起(keyup)时触发,它返回一个结果。
$("#myform").validate().element( "#myselect" );
$("#myform").validate().element( "#myselect" );
[3] resetForm( ) 返回:undefined
说明:重置表单。
恢复表单元素到原来的值(需要form插件支持),移除无效验证的样式并隐藏错误消息。
(...貌似只有在IE下才可以移除样式)
var validator = $("#myform").validate();
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
}
});
原文请见:http://docs.jquery.com/Plugins/Validation
(六)内置验证方法 (jQuery validation)
[1] required( ) 返回:Boolean
说明:让表单元素必须填写(选择)。
如果表单元素为空(text input)或未选择(radio/checkbox)或选择了一个空值(select)。
作用于text inputs, selects, checkboxes and radio buttons.
当select提供了一个空值选项<option value="">Choose...</option>则强迫用户去选择一个不为空的值。
$("#myform").validate({
rules: {
fruit: "required"
}
});
$("#myform").validate({
rules: {
fruit: "required"
}
});
[2] required( dependency-expression ) 返回:Boolean
参数 dependency-expression 类型:String 在form上下文中的一个表达式( String ),表单元素是否需要填写依赖于该表达式返回一个或多个元素。
说明:让表单元素必须填写(选择),依赖于参数的返回值。
表达式中像#foo:checked, #foo:filled, #foo:visible这样的选择过滤器将经常用到。
$("#myform").validate({
rules: {
details: {
required: "#other:checked"
}
}, debug:true
});
$("#other").click(function() {
$("#details").valid();
});
$("#myform").validate({
rules: {
details: {
required: "#other:checked"
}
}, debug:true
});
$("#other").click(function() {
$("#details").valid();
});
[3] required( dependency-callback ) 返回:Boolean
参数 dependency-callback 类型:Callback 该回函数以待验证表单元素作为其唯一的参数。当该回调函数返回true,则该表单元素是必须的。
说明:让表单元素必须填写(选择),依赖于参数的返回值。
表达式中像#foo:checked, #foo:filled, #foo:visible这样的选择过滤器将经常用到。
$("#myform").validate({
rules: {
age: {
required: true,
min: 3
},
parent: {
required: function(element) {
return $("#age").val() < 13;
}
}
}
});
$("#age").blur(function() {
$("#parent").valid();
});
$("#myform").validate({
rules: {
age: {
required: true,
min: 3
},
parent: {
required: function(element) {
return $("#age").val() < 13;
}
}
}
});
$("#age").blur(function() {
$("#parent").valid();
});
[4] remote( options ) 返回:Boolean
参数 options 类型:String, Options 请求服务器端资源的url(String)。或$.ajax()方法中的选项(Options)。
说明:请求服务器端资源验证。
服务器端的资源通过$.ajax (XMLHttpRequest)获取key/value对,响应返回true则表单通过验证。
$("#myform").validate({
rules: {
email: {
required: true,
email: true,
remote: "check-email.php"
}
}
});
$("#myform").validate({
rules: {
email: {
required: true,
email: true,
remote: "check-email.php"
}
}
});
[5] minlength( length ) 返回:Boolean
参数 length 类型:Integer 至少需要多少个字符数。
说明:确保表单元素满足给定的最小字符数。
在文本框(text input)中输入的字符太少、没有选中足够的复选框(checkbox)、一个选择框(select)中没有选中足够的选项。这以上三种情况中该方法返回false。
$("#myform").validate({
rules: {
field: {
required: true,
minlength: 3
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
minlength: 3
}
}
});
[6] maxlength( length ) 返回:Boolean
参数 length 类型:Integer 允许输入的最大字符数。
说明:确保表单元素的文本不超过给定的最大字符数。
在文本框(text input)中输入的字符太多、选择太多的复选框(checkbox)、一个选择框(select)中没有选中太多的选项。这以上三种情况中该方法返回false。
$("#myform").validate({
rules: {
field: {
required: true,
maxlength: 4
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
maxlength: 4
}
}
});
[7] rangelength( range ) 返回:Boolean
参数 range 类型:Array<Integer> 允许输入的字符数范围。
说明:确保表单元素的文本字符数在给定的范围当中。
在文本框(text input)中输入的字符数不在给定范围内、选择的复选框(checkbox)不在给在的范围内、一个选择框(select)选中的选项不在给定的范围内。这以上三种情况中该方法返回false。
$("#myform").validate({
rules: {
field: {
required: true,
rangelength: [2, 6]
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
rangelength: [2, 6]
}
}
});
[8] min( value ) 返回:Boolean
参数 value 类型:Integer 需要输入的最小整数。
说明:确保表单元素的值大于等于给定的最小整数。
该方法只在文本输入框(text input)下有效。
$("#myform").validate({
rules: {
field: {
required: true,
min: 13
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
min: 13
}
}
});
[9] max( value ) 返回:Boolean
参数 value 类型:Integer 给定的最大整数。
说明:确保表单元素的值小于等于给定的最大整数。
该方法只在文本输入框(text input)下有效。
$("#myform").validate({
rules: {
field: {
required: true,
max: 23
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
max: 23
}
}
});
[10] range( range ) 返回:Boolean
参数 range 类型:Array<Integer> 给定的整数范围。
说明:确保表单元素的值在给定的范围当中。
该方法只在文本输入框(text input)下有效。
$("#myform").validate({
rules: {
field: {
required: true,
range: [13, 23]
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
range: [13, 23]
}
}
});
[11] email( ) 返回:Boolean
说明:确保表单元素的值为一个有效的email地址。
如果值为一个有效的email地址,则返回true。该方法只在文本输入框(text input)下有效。
$("#myform").validate({
rules: {
field: {
required: true,
email: true
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
email: true
}
}
});
[12] url( ) 返回:Boolean
说明:确保表单元素的值为一个有效的URL地址(http://www.mydomain.com)。
如果值为一个有效的url地址,则返回true。该方法只在文本输入框(text input)下有效。
$("#myform").validate({
rules: {
field: {
required: true,
url: true
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
url: true
}
}
});
[13] date( ) dateISO( ) dateDE( ) 返回:Boolean
说明:用来验证有效的日期。这三个函数分别验证的日期格式为(mm/dd/yyyy)、(yyyy-mm-dd,yyyy/mm/dd)、(mm.dd.yyyy)。
$("#myform").validate({
rules: {
field: {
required: true,
date: true
/*dateISO: true
dateDE: true*/
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
date: true
/*dateISO: true
dateDE: true*/
}
}
});
[14] number( ) numberDE() 返回:Boolean
说明:用来验证小数。number()的小数点为圆点( . ),numberDE()的小数点为英文逗号( , )。
$("#myform").validate({
rules: {
field: {
required: true,
number: true
//numberDE: true
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
number: true
//numberDE: true
}
}
});
[15] digits() 返回:Boolean
说明:确保文本框中的值为数字。
$("#myform").validate({
rules: {
field: {
required: true,
digits: true
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
digits: true
}
}
});
[16] digits() 返回:Boolean
说明:确保文本框中的值为数字。
$("#myform").validate({
rules: {
field: {
required: true,
digits: true
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
digits: true
}
}
});
[17] accept( [extension] ) 返回:Boolean
参数 extension(Optional) 类型:String 允许的文件后缀名,用"|"或","分割。默认为"png|jpe?g|gif"
说明:确保表单元素接收给定的文件后缀名的文件。如果没有指定参数,则只有图片是允许的(png,jpeg,gif)。
$("#myform").validate({
rules: {
field: {
required: true,
accept: "xls|csv"
}
}
});
$("#myform").validate({
rules: {
field: {
required: true,
accept: "xls|csv"
}
}
});
[18] equalTo( other ) 返回:Boolean
参数 other 类型:Selector 要与当前值比较的另一个表单元素。
说明:确保两个表单元素的值是一致的。
$("#myform").validate({
rules: {
password: "required",
password_again: {
equalTo: "#password"
}
}
});
$("#myform").validate({
rules: {
password: "required",
password_again: {
equalTo: "#password"
}
}
});
原文请见:http://docs.jquery.com/Plugins/Validation
(七)注意事项 (jQuery validation)
[1]复杂的name属性值
当使用rules选项时,如果表单的name属性值包含有非法的javascript标识符,必须将name值加上引号。
$("#myform").validate({
rules: {
// no quoting necessary
name: "required",
// quoting necessary!
"user[email]": "email",
// dots need quoting, too!
"user.address.street": "required"
}
});
$("#myform").validate({
rules: {
// no quoting necessary
name: "required",
// quoting necessary!
"user[email]": "email",
// dots need quoting, too!
"user.address.street": "required"
}
});
[2]重构规则
不论什么时候,当你的表单中的多个字段含有相同的验证规则及验证消息,重构规则可以减少很多重复。使用 addMethod 和 addClassRules 将非常有效果。
假使已经重构了如下规则:
// alias required to cRequired with new message
$.validator.addMethod("cRequired", $.validator.methods.required,
"Customer name required");
// alias minlength, too
$.validator.addMethod("cMinlength", $.validator.methods.minlength,
// leverage parameter replacement for minlength, {0} gets replaced with 2
$.format("Customer name must have at least {0} characters"));
// combine them both, including the parameter for minlength
$.validator.addClassRules("customer", { cRequired: true, cMinlength: 2 });
// alias required to cRequired with new message
$.validator.addMethod("cRequired", $.validator.methods.required,
"Customer name required");
// alias minlength, too
$.validator.addMethod("cMinlength", $.validator.methods.minlength,
// leverage parameter replacement for minlength, {0} gets replaced with 2
$.format("Customer name must have at least {0} characters"));
// combine them both, including the parameter for minlength
$.validator.addClassRules("customer", { cRequired: true, cMinlength: 2 });
那么使用的时候如下:
<input name="customer1" class="customer" />
<input name="customer2" class="customer" />
<input name="customer3" class="customer" />
<input name="customer1" />
<input name="customer2" />
<input name="customer3" />
[3]验证消息
当验证了一个无效的表单元素,验证消息显示在用户面前。这些消息是从哪里来的呢?有三个途径来取得验证消息。
1.通过待验证表单元素的title属性
2.通过默认的验证消息
3.通过插件设置(messages选项)
这三种途径的优先顺序为:3 > 1 > 2
[4]验证消息与Google工具栏的冲突
有时候验证消息会与Goole工具栏的AutoFill插件冲突。AutoFill通过替换表单元素的title属性,以显示提示消息。此时,验证消息如果获取的是title属性值,那么就得不到我们预期想要得到的结果。当文档载入时,可以通过如下方法避免冲突。
$("input.remove_title").attr("title", "");
$("input.remove_title").attr("title", "");
[5]表单提交
默认地,表单验证失败时阻止表单的提交,当验证通过,表单提交。当然,也可以通过submitHandler来自定义提交事件。
将提交按钮的class属性设置成cancel,在表单提交时可以跳过验证。
<input type="submit" name="submit" value="Submit" />
<input type="submit" class="cancel" name="cancel" value="Cancel" />
<input type="submit" name="submit" value="Submit" />
<input type="submit" name="cancel" value="Cancel" />
下面这段代码将循环提交表单:
$("#myform").validate({
submitHandler: function(form) {
// some other code maybe disabling submit button
// then:
$(form).submit();
}
});
$("#myform").validate({
submitHandler: function(form) {
// some other code maybe disabling submit button
// then:
$(form).submit();
}
});
$(form).submit() 触发了另外一轮的验证,验证后又去调用submitHandler,然后就循环了。可以用 form.submit() 来触发原生的表单提交事件。
$("#myform").validate({
submitHandler: function(form) {
form.submit();
}
});
$("#myform").validate({
submitHandler: function(form) {
form.submit();
}
});
原文请见:http://docs.jquery.com/Plugins/Validation
(八)应用实例 (jQuery validation)
[1]验证页面
<%@ page language="java" import="java.util.*" pageEncoding="gb2312"%>
<html>
<head>
<title>jquery验证框架</title>
<link rel="stylesheet" type="text/css" href="css/index.css">
<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" src=js/jquery.form.js></script>
<script type="text/javascript" src=js/valid.js></script>
<style type="text/css">
label { width: 10em; float: left; }
label.haha {color: red; padding-left: 18px; vertical-align: top;width: 196px; background: url("images/unchecked.gif") no-repeat;}
input.haha { border: 1px solid red; }
label.valid {background: url("images/checked.gif") no-repeat; color: #065FB9;}
input.focus { border: 2px solid green; }
ul li{ display: block;}
</style>
</head>
<body>
<div id="form_con">
<form class="cmxform" id="myform" method="post" action="">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td>用户名</td>
<td><input type="text" name="username" class="required" /></td>
<td></td>
</tr>
<tr>
<td>密码</td>
<td><input id="password" type="password" name="firstpwd" /></td>
<td></td>
</tr>
<tr>
<td>验证密码</td>
<td><input type="password" name="secondpwd" /></td>
<td></td>
</tr>
<tr>
<td>性别</td>
<td><input id="sex" type="radio" name="sex" />男<input type="radio" name="sex" />女</td>
<td></td>
</tr>
<tr>
<td>年龄</td>
<td><input type="text" name="age" /></td>
<td></td>
</tr>
<tr>
<td>邮箱</td>
<td><input type="text" name="email" /></td>
<td></td>
</tr>
<tr>
<td>个人网页</td>
<td><input type="text" name="purl" /></td>
<td></td>
</tr>
<tr>
<td>电话</td>
<td><input type="text" name="telephone" /></td>
<td></td>
</tr>
<tr>
<td>附件</td>
<td><input type="file" name="afile"/></td>
<td></td>
</tr>
<tr><td colspan="3" ><input type="submit" name="submit" value="提交" /><button>重置</button></td></tr>
</tbody>
</table>
</form>
</div>
</body>
</html>
<%@ page language="java" import="java.util.*" pageEncoding="gb2312"%>
<html>
<head>
<title>jquery验证框架</title>
<link rel="stylesheet" type="text/css" href="css/index.css">
<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" src=js/jquery.form.js></script>
<script type="text/javascript" src=js/valid.js></script>
<style type="text/css">
label { width: 10em; float: left; }
label.haha {color: red; padding-left: 18px; vertical-align: top;width: 196px; background: url("images/unchecked.gif") no-repeat;}
input.haha { border: 1px solid red; }
label.valid {background: url("images/checked.gif") no-repeat; color: #065FB9;}
input.focus { border: 2px solid green; }
ul li{ display: block;}
</style>
</head>
<body>
<div id="form_con">
<form id="myform" method="post" action="">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td>用户名</td>
<td><input type="text" name="username" /></td>
<td></td>
</tr>
<tr>
<td>密码</td>
<td><input id="password" type="password" name="firstpwd" /></td>
<td></td>
</tr>
<tr>
<td>验证密码</td>
<td><input type="password" name="secondpwd" /></td>
<td></td>
</tr>
<tr>
<td>性别</td>
<td><input id="sex" type="radio" name="sex" />男<input type="radio" name="sex" />女</td>
<td></td>
</tr>
<tr>
<td>年龄</td>
<td><input type="text" name="age" /></td>
<td></td>
</tr>
<tr>
<td>邮箱</td>
<td><input type="text" name="email" /></td>
<td></td>
</tr>
<tr>
<td>个人网页</td>
<td><input type="text" name="purl" /></td>
<td></td>
</tr>
<tr>
<td>电话</td>
<td><input type="text" name="telephone" /></td>
<td></td>
</tr>
<tr>
<td>附件</td>
<td><input type="file" name="afile"/></td>
<td></td>
</tr>
<tr><td colspan="3" ><input type="submit" name="submit" value="提交" /><button>重置</button></td></tr>
</tbody>
</table>
</form>
</div>
</body>
</html>
[2]验证js
$(function(){
var validator = $("#myform").validate({
debug: true, //调试模式取消submit的默认提交功能
errorClass: "haha",//默认为错误的样式类为:error
focusInvalid: false,
onkeyup: false,
submitHandler: function(form){ //表单提交句柄,为一回调函数,带一个参数:form
alert("提交表单");
//form.submit(); 提交表单
},
rules: { //定义验证规则,其中属性名为表单的name属性
username: {
required: true,
minlength: 2,
remote: "uservalid.jsp" //传说当中的ajax验证
},
firstpwd: {
required: true,
//minlength: 6
rangelength: [6,8]
},
secondpwd: {
required: true,
equalTo: "#password"
},
sex: {
required: true
},
age: {
required: true,
range: [0,120]
},
email: {
required: true,
email: true
},
purl: {
required: true,
url: true
},
afile: {
required: true,
accept: "xls,doc,rar,zip"
}
},
messages: { //自定义验证消息
username: {
required: "用户名是必需的!",
minlength: $.format("用户名至少要{0}个字符!"),
remote: $.format("{0}已经被占用")
},
firstpwd: {
required: "密码是必需的!",
rangelength: $.format("密码要在{0}-{1}个字符之间!")
},
secondpwd: {
required: "密码验证是必需的!",
equalTo: "密码验证需要与密码一致"
},
sex: {
required: "性别是必需的"
},
age: {
required: "年龄是必需的",
range: "年龄必须介于{0}-{1}之间"
},
email: {
required: "邮箱是必需的!",
email: "请输入正确的邮箱地址(例如 [email protected])"
},
purl: {
required: "个人主页是必需的",
url: "请输入正确的url格式,如 http://www.domainname.com"
},
afile: {
required: "附件是必需的!",
accept: "只接收xls,doc,rar,zip文件"
}
},
errorPlacement: function(error, element) { //验证消息放置的地方
error.appendTo( element.parent("td").next("td") );
},
highlight: function(element, errorClass) { //针对验证的表单设置高亮
$(element).addClass(errorClass);
},
success: function(label) {
label.addClass("valid").text("Ok!")
}
/*,
errorContainer: "#error_con", //验证消息集中放置的容器
errorLabelContainer: "#error_con ul", //存放消息无序列表的容器
wrapper: "li", //将验证消息用无序列表包围
validClass: "valid", //通过验证的样式类
errorElement: "em", //验证标签的名称,默认为:label
success: "valid" //验证通过的样式类
*/
});
$("button").click(function(){
validator.resetForm();
});
//alert($("#password").rules()["required"]);
//validator.showErrors({"username": "用户名是必需的"});
/*$("button").click(function () {
var str = "Hello {0}, this is {1}";
alert("'" + str + "'");
str = $.validator.format(str, ["koala","oo"]);
alert("'" + str + "'");
});*/
});
$(function(){
var validator = $("#myform").validate({
debug: true, //调试模式取消submit的默认提交功能
errorClass: "haha",//默认为错误的样式类为:error
focusInvalid: false,
onkeyup: false,
submitHandler: function(form){ //表单提交句柄,为一回调函数,带一个参数:form
alert("提交表单");
//form.submit(); 提交表单
},
rules: { //定义验证规则,其中属性名为表单的name属性
username: {
required: true,
minlength: 2,
remote: "uservalid.jsp" //传说当中的ajax验证
},
firstpwd: {
required: true,
//minlength: 6
rangelength: [6,8]
},
secondpwd: {
required: true,
equalTo: "#password"
},
sex: {
required: true
},
age: {
required: true,
range: [0,120]
},
email: {
required: true,
email: true
},
purl: {
required: true,
url: true
},
afile: {
required: true,
accept: "xls,doc,rar,zip"
}
},
messages: { //自定义验证消息
username: {
required: "用户名是必需的!",
minlength: $.format("用户名至少要{0}个字符!"),
remote: $.format("{0}已经被占用")
},
firstpwd: {
required: "密码是必需的!",
rangelength: $.format("密码要在{0}-{1}个字符之间!")
},
secondpwd: {
required: "密码验证是必需的!",
equalTo: "密码验证需要与密码一致"
},
sex: {
required: "性别是必需的"
},
age: {
required: "年龄是必需的",
range: "年龄必须介于{0}-{1}之间"
},
email: {
required: "邮箱是必需的!",
email: "请输入正确的邮箱地址(例如 [email protected])"
},
purl: {
required: "个人主页是必需的",
url: "请输入正确的url格式,如 http://www.domainname.com"
},
afile: {
required: "附件是必需的!",
accept: "只接收xls,doc,rar,zip文件"
}
},
errorPlacement: function(error, element) { //验证消息放置的地方
error.appendTo( element.parent("td").next("td") );
},
highlight: function(element, errorClass) { //针对验证的表单设置高亮
$(element).addClass(errorClass);
},
success: function(label) {
label.addClass("valid").text("Ok!")
}
/*,
errorContainer: "#error_con", //验证消息集中放置的容器
errorLabelContainer: "#error_con ul", //存放消息无序列表的容器
wrapper: "li", //将验证消息用无序列表包围
validClass: "valid", //通过验证的样式类
errorElement: "em", //验证标签的名称,默认为:label
success: "valid" //验证通过的样式类
*/
});
$("button").click(function(){
validator.resetForm();
});
//alert($("#password").rules()["required"]);
//validator.showErrors({"username": "用户名是必需的"});
/*$("button").click(function () {
var str = "Hello {0}, this is {1}";
alert("'" + str + "'");
str = $.validator.format(str, ["koala","oo"]);
alert("'" + str + "'");
});*/
});
[3]远程验证程序
<%@ page language="java" import="java.io.PrintWriter" pageEncoding="gb2312"%><%
String username = request.getParameter("username");
PrintWriter pw = response.getWriter();
try{
if(username.toLowerCase().equals("admin")){
pw.println("true");
}else{
pw.println("false");
}
}catch(Exception ex){
ex.getStackTrace();
}finally{
pw.flush();
pw.close();
}
%>
<%@ page language="java" import="java.io.PrintWriter" pageEncoding="gb2312"%><%
String username = request.getParameter("username");
PrintWriter pw = response.getWriter();
try{
if(username.toLowerCase().equals("admin")){
pw.println("true");
}else{
pw.println("false");
}
}catch(Exception ex){
ex.getStackTrace();
}finally{
pw.flush();
pw.close();
}
%>