学习要点:
1.使用 validate.js 插件
2.默认验证规则
3.validate()方法和选项
4.validate.js 其他功能
验证插件(validate.js),是一款验证常规表单数据合法性的插件。使用它,极大的解放了在表单上繁杂的验证过程,并且错误提示显示的完善也增加了用户体验。
一.使用
validate.js 插件
官网下载:http://bassistance.de/jquery-plugins/jquery-plugin-validation最重要的文件是validate.js,还有两个可选的辅助文件:additional-methods.js(控件 class方式)和 message_zh.js(提示汉化)文件(实际使用,请使用 min 压缩版) 。
第一步:引入 validate.js
<script type="text/javascript"
src="js/jquery.validate.js"></script>
第二步:在 JS 文件中执行
$('#reg').validate();
二.默认验证规则
Validate.js 的默认验证规则的写法有两种形式:1.控件属性方式;2.JS 键值对传参方式。
//使用控件方式验证“必填和不得小于两位”
<input type="text" class="required" minlength="2" name="user" id="user" />
注意:默认规则里设置布尔值的,直接写到 class 里即可实现。如果是数字或数组区间,直接使用属性=值的方式即可。而对于错误提示,可以引入中文汉化文件,或直接替换掉即可。
//使用 JS 对象键值对传参方式设置
1 $('#reg').validate({ 2 rules : { 3 user : { //只有一个规则的话, 4 required : true, //直接 user : 'required', 5 minlength : 2, 6 }, 7 }, 8 messages : { 9 user : { 10 required : '帐号不得为空!', 11 minlength : '帐号不得小于 2 位!', 12 }, 13 } 14 });
注意:由于第一种形式不能设置指定的错误提示信息。我们推荐使用第二种形式,第二种形式也避免的 HTML 污染。
//所有规则演示
1 $('#reg').validate({ 2 rules : { 3 email : { 4 email : true, 5 }, 6 url : { 7 url : true, 8 }, 9 date : { 10 date : true, 11 }, 12 dateIOS : { 13 dateIOS : true, 14 }, 15 number : { 16 number : true, 17 } 18 digits : { 19 digits : true, 20 }, 21 creditcard : { 22 creditcard : true, 23 }, 24 min : { 25 min : 5, 26 }, 27 range : { 28 range : [5, 10], 29 }, 30 rangelength : { 31 rangelength : [5,10], 32 }, 33 notpass : { 34 equalTo : '#pass', //这里的 To 是大写的 T 35 } 36 }, 37 })
三.validate()的方法和选项
除了默认的验证规则外,validate.js 还提供了大量的其他属性和方法供开发者使用。比如,调试属性,错误提示位置一系列比较有用的选项。
//jQuery.format 格式化错误提示
1 $('#reg').validate({ 2 rules : { 3 user : { 4 required : true, 5 minlength : 5, 6 rangelength : [5,10] 7 }, 8 }, 9 messages : { 10 user : { 11 required : '帐号不得为空!', 12 minlength : jQuery.format('帐号不得小于{0}位!'), 13 rangelength : jQuery.format('帐号限制在{0}-{1}位!'), 14 }, 15 }, 16 });
//开启调试模式禁止提交
$('#reg').validate({
debug : true,
});
//设置调试模式为默认,可以禁止多个表单提交
$.validator.setDefaults({
debug : true, //仍可以正常验证,但是为了方便调试不会提交到指定页面
});
//使用其他方式代替默认提交
submitHandler : function (form) {
//可以执行 ajax 提交,并且无须 debug:true 阻止提交了
},
//忽略某个字段验证
ignore : '#pass',
//群组错误提示
groups : {
myerror : 'user pass',
},
//显示群组的错误提示
focusInvalid : false,
errorPlacement : function (error, element) {
$.each(error, function (index, value) {
$('.myerror').html($('.myerror').html() + $(value).html());
})
},
//群组错误提示,分开
groups : {
error_user : 'user',
error_pass : 'pass'
},
//将群组的错误指定存放位置(推荐!!)
1 errorPlacement : function (error, element) { 2 error.appendTo('.myerror'); 3 },
//设置错误提示的 class 名
errorClass : 'error_list',
//设置错误提示的标签
errorElement : 'p',
PS:默认的class名称是“error”,默认的错误提示标签是label。
//统一包裹错误提示
(首先将错误信息标签外面再包裹一层li,然后再html文件中提前设置了错误信息显示元素class为error的ol,这两行代码就将错误信息形成了一个列表样式)
errorLabelContainer : 'ol.error',
wrapper : 'li',
//设置成功后加载的 class
success : 'success',
PS:验证成功之后会在label标签中添加一个sucess类名,然后就可以根据这个设置成功后的的css样式。另外注意:成功之后,对应的input元素里面的class值会有error变为valid,这样也可以根据这个class值设置css样式,样成功后的提示显示在input里面,而不是用success显示在input外面。
//使用方法加载 class 并添加文本
success : function (label) {
label.addClass('success').text('ok');
},
//高亮显示有错误的元素,变色式
highlight: function(element, errorClass) {
$(element).fadeOut(function() {
$(element).fadeIn()
})
},
1 //高亮显示有错误的元素,变色式 2 highlight: function(element, errorClass) { 3 $(element).css('border', '1px solid red'); 4 }, 5 6 //成功的元素移出错误高亮 7 unhighlight : function (element, errorClass) { 8 $(element).css('border', '1px solid #ccc'); 9 },
//表单提交时获取信息
invalidHandler : function (event, validator) {
var errors = validator.numberOfInvalids();
if (errors) {
$('.myerror').html('您有' +
errors + '个表单元素填写非法!');
}
},
1 //获取错误提示句柄,不用提交及时获取值 2 showErrors : function (errorMap, errorList) { 3 var errors = this.numberOfInvalids(); 4 if (errors) { 5 $('.myerror').html('您有' + errors + '个表单元素填写非法!'); 6 } else { 7 $('.myerror').hide(); 8 } 9 this.defaultShowErrors(); //执行默认错误 10 }, 11 12 13 //获取错误提示句柄,errorList 14 showErrors : function (errorMap, errorList) { 15 alert(errorList[0].message); //得到错误信息 16 alert(errorList[0].element); //当前错误的表单元素 17 },
四.validate.js 其他功能
使用 remote:url,可以对表单进行 ajax 验证,默认会提交当前验证的值到远程地址。如果需要提交其他的值,可以使用 data 选项。
//使用 ajax 验证
rules : { user : { required : true, minlength : 2, remote : 'user.php', }, },
//user.php 内容
1 <?php 2 if ($_GET['user'] == 'alex') { 3 echo 'false'; 4 } else { 5 echo 'true'; 6 } 7 ?>
注意:远程地址只能输出'true'或'false',不能输出其他值。
//同时传递多个值到远程端
1 pass : { 2 required : true, 3 minlength : 6, 4 remote : { 5 url : 'user.php', 6 type : 'POST', 7 dataType : 'json', 8 data : { 9 user : function () { 10 return $('#user').val(); 11 }, 12 }, 13 }, 14 },
//user.php 内容
1 <?php 2 if ($_POST['user'] != 'alex' || $_POST['pass'] != '123456') { 3 echo 'false'; 4 } else { 5 echo 'true'; 6 } 7 ?>
validate.js 提供了一些事件触发的默认值,这些值呢,大部分建议是不用更改的。
//取消提交验证
onsubmit : false, //默认是 true
注意: 设置为false 会导致直接传统提交, 不会实现验证功能, 一般是用于keyup/click/blur验证提交。
//设置鼠标离开不触发验证
onfocusout : false, //默认为 true
//设置键盘按下弹起不触发验证
onkeyup : false, //默认为 true
注意:只要设置了,在测试的浏览器不管是 false 还是 true 都不触发了。
//设置点击 checkbox 和 radio 点击不触发验证
onclick : false, //默认为 true
//设置错误提示后,无法获取焦点
focusInvalid : false, //默认为 true
//提示错误时,隐藏错误提示,不能和 focusInvalid 一起用,冲突
focusCleanup : true, //默认为 false
如果表单元素设置了 title 值,且 messages 为默认,就会读取 title 值的错误信息,我们可以通过 ignoreTitle : true,设置为 true,屏蔽这一个功能。
ignoreTitle : true, //默认为 false
//判断表单所验证的元素是否全部有效
alert($('#reg').valid()); //全部有效返回 true
Validate.js 提供了可以单独验证每个表单元素的 rules 方法,不但提供了 add 增加验证,还提供了 remove 删除验证的功能。
//给 user 增加一个表单验证
1 $('#user').rules('add', { 2 required : true, 3 minlength : 2, 4 messages : { 5 required : '帐号不得为空!', 6 minlength : jQuery.format('帐号不得小于{0}位!'), 7 } 8 });
//删除 user 的所有验证规则
$('#user').rules('remove');
//删除 user 的指定验证规则
$('#user').rules('remove', 'minlength min max');
1 //添加自定义验证 2 $.validator.addMethod('code', function (value, element) { 3 var tel = /^[0-9]{6}$/; 4 return this.optional(element) || (tel.test(value)); 5 }, '请正确填写您的邮政编码'); 6 7 //调用自定义验证 8 rules : { 9 code : { 10 required : true, 11 code : true, 12 } 13 } 14 15