[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 name@domain.com"
}
}
})
$(".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定义组消息的存放位置。
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时，只能用其它的事件验证。
1. $(".selector").validate({
2. onsubmit: false
3. })
$(".selector").validate({
onsubmit: false
})
[9] onfocusout 类型：Boolean 默认：true
说明：焦点离开时验证（单选/复选按钮除外）。如果表单中没有输入任何内容，所有的规则将被跳过，除非该表单已经被标记为无效的。
$(".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
})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
}
});
296
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
