jQuery基础之表单验证
在使用jquery-validate.js插件时可以做一些初始化配置
在初始化jquery-validate.js对象的时候,将外部的一些配置和该插件内部的一些默认配置合并在一起,如果有相同的配置,前者覆盖后者(默认)的配置
// constructor for validator $.validator = function( options, form ) { this.settings = $.extend( true, {}, $.validator.defaults, options ); this.currentform = form; this.init(); };
rules的格式
标准格式是 key为字符串,value为对象字面直接量
rules : { username: { required: true, minlength: 2 } }
也可以是
key为字符串,value也为特定的字符串(“required”)
ulus: { username: "required" }
在插件中会将上面格式调整为:{required:true}的形式。从下面代码可以看出对于usernname:”minlength”就不适用了,它会把它变成{minlength:true}这规则明显不合适
// converts a simple string to a {string: true} rule, e.g., "required" to {required:true} normalizerule: function( data ) { if ( typeof data === "string" ) { var transformed = {}; $.each( data.split( /\s/ ), function() { transformed[ this ] = true; } ); data = transformed; } return data; }
jquery-validate.js将这些规则解析后放到rules这个对象用以供校验时访问
插件事件监听处理
在指定的元素上添加事件监听
$( this.currentform ) .on( "focusin.validate focusout.validate keyup.validate", ":text, [type='password'], [type='file'], select, textarea, [type='number'], [type='search'], " + "[type='tel'], [type='url'], [type='email'], [type='datetime'], [type='date'], [type='month'], " + "[type='week'], [type='time'], [type='datetime-local'], [type='range'], [type='color'], " + "[type='radio'], [type='checkbox'], [contenteditable], [type='button']", delegate ) // support: chrome, oldie // "select" is provided as event.target when clicking a option .on( "click.validate", "select, option, [type='radio'], [type='checkbox']", delegate )
上面的监听事件看起来很奇怪,用空格分隔,外加命名空间,如果不了解on的这些使用方法可以参考query.on() 函数详解。之前focusin,focusout,keyup都是标准事件,之前一直以为focusin与focusout是自定义的事件,这里需要注意一下。
监听函数处理
function delegate( event ) {
// set form expando on contenteditable
if ( !this.form && this.hasattribute( "contenteditable" ) ) {
this.form = $( this ).closest( "form" )[ 0 ];
}
var validator = $.data( this.form, "validator" ),
eventtype = "on" + event.type.replace( /^validate/, "" ),
settings = validator.settings;
if ( settings[ eventtype ] && !$( this ).is( settings.ignore ) ) {
settings[ eventtype ].call( validator, this, event );
}
}
在插件中的settings放置了事件处理函数(settings[ eventtype ].call( validator, this, event );,也就是在defaults中定义的onfocusin,onfocusout,onkeyup,onclick,highlight,unhighlight事件,因为在defaults中所以可以在外部重写这些事件,做一些定制样式,这点会在最后重新封装一个适合自己的表单校验插件)
自定义事件
现在仔细探究一下这些自定义事件在插件中是如何工作的
先看一下jquery提供的一个trigger() 方法
trigger() 方法触发被选元素的指定事件类型。
格式:$(selector).trigger(event,[param1,param2,…])
event 必需。规定指定元素要触发的事件。可以使自定义事件(使用 bind() 函数来附加),或者任何标准事件。
[param1,param2,…] 可选。传递到事件处理程序的额外参数。额外的参数对自定义事件特别有用。
注意到了trigger可以触发bind函数绑定的事件(bind现在用on取代),也就是说只要我在on中定义一些自定义的事件,都是可以通过trigger触发
例子-trigger
<!doctype html>
<html>
<head>
<title>jquery-validation demo | bootstrap</title>
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css" />
<script type="text/javascript" src="js/jquery-1.11.1.js"></script>
<script type="text/javascript" src="js/jquery.validate.js"></script>
</head>
<body>
<div class="listener">
<input type="text" />
<p class="validate"></p>
</div>
<script type="text/javascript">
$(".listener").on("customizeevent otherevent",".validate,[type='text']",function() {
alert("complete some logical codes here");
})
$(".validate").trigger("customizeevent");
$("[type='text']").trigger("customizeevent");
$("[type='text']").trigger("otherevent");
</script>
</body>
</html>
上面的代码中on的第一个参数有两种事件,使用space隔开(这样两种事件都会绑定指定的事件处理函数),第二个参数指定了可以触发这个自定义事件的一些元素(满足选择器[type=’text’],validate的元素),第三个参数是指定使用trigger触发这些事件时执行的处理函数
在接下来执行事件的触发,从代码中可以看到我选择对两个元素触发了不同的事件。
插件表单submit监听
插件绑定了submit的监听事件(.validate为命名空间),当我们通过$(“form”).submit() 或直接点击type=“submit”(input , button可以指定type=“submit”)触发submit事件时,会执行绑定好的处理函数
例子-绑定submit
this.on( "submit.validate", function( event )
// prevent submit for invalid forms or custom submit handlers if ( validator.cancelsubmit ) { validator.cancelsubmit = false; return handle(); } if ( validator.form() ) { //校验表单成功 if ( validator.pendingrequest ) { validator.formsubmitted = true; return false; } return handle(); } else { validator.focusinvalid(); return false; }
cancelsubmit
cancelsubmit 是validator对象的成员属性,当满足选择器”:submit”(input,button 的type为submit或者button没有指定类型多数浏览器会把button当做类型为 submit 的按钮)的按钮触发点击事件时,会查看这个按钮上是否包含class为“cancel”或者有formnovalidate=“formnovalidate”属性,如果按钮存在其中一种,那么就不会进行表单校验直接提交form表单(设置validator.cancelsubmit=true)。
validator.form()
使用validator.form()进行表单元素校验,如果为true,判断validator.pendingrequest是否为true,如果是则不提交form,如果false则执行handle函数(handle执行的是submithandler()的处理)
submithandler
插件可以在外部配置submithandler处理函数,它的意思就是在form表单提交时可以做一些额外的处理,并通过返回true,false来决定表单是否提交。
function handle() { //提交表单 var hidden, result; if ( validator.settings.submithandler ) { if ( validator.submitbutton ) { // insert a hidden input as a replacement for the missing submit button hidden = $( "<input type='hidden'/>" ) .attr( "name", validator.submitbutton.name ) .val( $( validator.submitbutton ).val() ) .appendto( validator.currentform ); } result = validator.settings.submithandler.call( validator, validator.currentform, event ); if ( validator.submitbutton ) { // and clean up afterwards; thanks to no-block-scope, hidden can be referenced hidden.remove(); } if ( result !== undefined ) { return result; } return false; } return true; }
生成一个hidden的input隐藏域,在执行完submithandler以后移除,没能明白这里的意图。 执行submithandler后会有一个返回结果(true | false | undefined),如果自定义的submithandler没有return返回则结果是undefined,这样导致handle()结果为false,表单不会被提交
插件表单校验的规则
email
/^[a-za-z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-za-z0-9](?:[a-za-z0-9-]{0,61}[a-za-z0-9])?(?:\.[a-za-z0-9](?:[a-za-z0-9-]{0,61}[a-za-z0-9])?)*$/
1
url
/^(?:(?:(?:https?|ftp):)?\/\/)(?:\s+(?::\s*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)(?:\.(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)*(?:\.(?:[a-z\u00a1-\uffff]{2,})).?)(?::\d{2,5})?(?:[/?#]\s*)?$/i
1
时间
!/invalid|nan/.test( new date( value ).tostring()
1
电话号码
/^(?:-?\d+|-?\d{1,3}(?:,\d{3})+)?(?:\.\d+)?$/.test( value );
1
数字
/^\d+$/.test( value )
1
minlength
minlength: function( value, element, param ) {
var length = $.isarray( value ) ? value.length : this.getlength( value, element );
return this.optional( element ) || length >= param;
},
相信很多人在刚接触前端或者中期时候总会遇到一些问题及瓶颈期,如学了一段时间没有方向感或者坚持不下去一个人学习枯燥乏味有问题也不知道怎么解决,对此我整理了一些资料 喜欢我的文章想与更多资深大牛一起讨论和学习的话 欢迎加入我的学习交流群
907694362
maxlength
maxlength: function( value, element, param ) {
var length = $.isarray( value ) ? value.length : this.getlength( value, element );
return this.optional( element ) || length <= param;
}
rangelength
rangelength: function( value, element, param ) {
var length = $.isarray( value ) ? value.length : this.getlength( value, element );
return this.optional( element ) || ( length >= param[ 0 ] && length <= param[ 1 ] );
}
equalto
equalto: function( value, element, param ) {
// bind to the blur event of the target in order to revalidate whenever the target field is updated
var target = $( param );
if ( this.settings.onfocusout && target.not( ".validate-equalto-blur" ).length ) {
target.addclass( "validate-equalto-blur" ).on( "blur.validate-equalto", function() {
$( element ).valid();
} );
}
return value === target.val();
}