jQuery.validate 中文API-3
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:{
?????? required:"E-mail不能为空",
?????? email:"E-mail地址不正确"
???? }
?? }
})
groups:
对一组元素的验证,用一个错误提示,用error Placement控制把出错信息放在哪里
$("#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
})
Onubmit Boolean 默认:true
是否提交时验证
$(".selector").validate({
?? onsubmit:false
})
onfocusout Boolean 默认:true?
是否在获取焦点时验证
$(".selector").validate({
?? onfocusout:false
})
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({
?? errorClass:"invalid"
})
errorElement String 默认:"label"
使用什么标签标记错误
$(".selector").validate
?? errorElement:"em"
})
wrapper String
使用什么标签再把上边的errorELement包起来
$(".selector").validate({
?? wrapper:"li"
})
errorLabelContainer Selector
把错误信息统一放在一个容器里面
$("#myform").validate({
?? errorLabelContainer:"#messageBox",
?? wrapper:"li",
?? submitHandler:function() { alert("Submitted!") }
})
?
showErrors:
跟一个函数,可以显示总共有多少个未通过验证的元素
$(".selector").validate({
?? showErrors:function(errorMap,errorList) {
??????? $("#summary").html("Your form contains " + this.numberOfInvalids() + " errors,see details below.");
??????? this.defaultShowErrors();
?? }
})
errorPlacement:
跟一个函数,可以自定义错误放到哪里
$("#myform").validate({
? errorPlacement:function(error,element) {? error.appendTo(element.parent("td").next("td"));
?? },
?? debug:true
?
})
success:
要验证的元素通过验证后的动作,如果跟一个字符串,会当做一个css类,也可跟一个函数
$("#myform").validate({
??????? success:"valid",
??????? submitHandler:function() { alert("Submitted!") }
})
highlight:
可以给未通过验证的元素加效果,闪烁等
?