版本号:Validform_v5.3.2
下载地址:http://validform.rjboy.cn/download.html
一、引入CSS
.Validform_checktip{ margin-left:8px; line-height:20px; height:20px; overflow:hidden; color:#999; font-size:12px; } .Validform_right{ color:#71b83d; padding-left:20px; background:url(../images/right.png) no-repeat left center; } .Validform_wrong{ color:red; padding-left:20px; white-space:nowrap; background:url(../images/error.png) no-repeat left center; } .Validform_loading{ padding-left:20px; background:url(../images/onLoad.gif) no-repeat left center; } .Validform_error{ background-color:#ffe7e7; } #Validform_msg{color:#7d8289; font: 12px/1.5 tahoma, arial, \5b8b\4f53, sans-serif; width:280px; -webkit-box-shadow:2px 2px 3px #aaa; -moz-box-shadow:2px 2px 3px #aaa; background:#fff; position:absolute; top:0px; right:50px; z-index:99999; display:none;filter: progid:DXImageTransform.Microsoft.Shadow(Strength=3, Direction=135, Color='#999999');} #Validform_msg .iframe{position:absolute; left:0px; top:-1px; z-index:-1;} #Validform_msg .Validform_title{line-height:25px; height:25px; text-align:left; font-weight:bold; padding:0 8px; color:#fff; position:relative; background-color:#000;} #Validform_msg a.Validform_close:link,#Validform_msg a.Validform_close:visited{line-height:22px; position:absolute; right:8px; top:0px; color:#fff; text-decoration:none;} #Validform_msg a.Validform_close:hover{color:#cc0;} #Validform_msg .Validform_info{padding:8px;border:1px solid #000; border-top:none; text-align:left;}
二、引入js
validform 是基于jquery开发的,所有需要在validform前引入 jquery
三、初始化
<script> $( function(){ $(".reg_form").Validform(); }); </script>
注:
1、Validform有非压缩、压缩和NCR三个版本提供下载,NCR是通用版,当你页面因编码问题,提示文字出现乱码时可以使用这个版本;
2、Validform没有限定必须使用table结构,它可以适用于任何结构,需要在tiptype中定义好位置关系。
四、绑定到html
<div class="reg_form"> <form class="demo" action="/member/register"> <div class="reg_br"> <div class="reg_l">邮箱:</div> <div class="reg_r"> <input id="email" type="text" name="email" datatype="e" ajaxurl="/member/ajaxcheckemail" nullmsg="邮箱不能为空!" errormsg="请输入合法的邮箱地址!" class="required email"/> </div> <div class="clear"></div> </div> <div class="reg_br"> <div class="reg_l">昵称:</div> <div class="reg_r"><input id="nick_name" datatype="*2-20" ajaxurl="/member/ajaxchecknickname" nullmsg="昵称不能为空!" errormsg="2-20个英文或汉字" type="text" name="nick_name" /></div> <div class="clear"></div> </div> </form> </div>
凡要验证格式的元素均需绑定datatype属性,datatype可选值内置有10类,用来指定不同的验证格式。
如果还不能满足您的验证需求,可以传入自定义datatype,自定义datatype是一个非常强大的功能,通过它可以满足你的任何需求。
可以绑定的附加属性有:datatype、nullmsg、sucmsg、errormsg、ignore、recheck、tip、altercss、ajaxurl 和plugin
{"status":"y","info":"验证通过"},期中info是前端的提示信息
!跟callback里的ajax返回数据格式统一,建议不再返回字符串"y"或"n"。目前这两种格式的数据都兼容。
注: $(".demoform").Validform({ usePlugin:{ datepicker:{} } }); 5.3版开始,不需要传入这些空对象了,只需在表单元素上绑定plugin="datepicker"就可以,初始化直接这样: $(".demoform").Validform();
初始化参数说明
$(".demoform").Validform({ btnSubmit:"#btn_sub", btnReset:".btn_reset", tiptype:1, ignoreHidden:false, dragonfly:false, tipSweep:true, label:".label", showAllError:false, postonce:true, ajaxPost:true, datatype:{ "*6-20": /^[^\s]{6,20}$/, "z2-4" : /^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/, "username":function(gets,obj,curform,regxp){ //参数gets是获取到的表单元素值,obj为当前表单元素,curform为当前验证的表单,regxp为内置的一些正则表达式的引用; var reg1=/^[\w\.]{4,16}$/, reg2=/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,8}$/; if(reg1.test(gets)){return true;} if(reg2.test(gets)){return true;} return false; //注意return可以返回true 或 false 或 字符串文字,true表示验证通过,返回字符串表示验证失败,字符串作为错误提示显示,返回false则用errmsg或默认的错误提示; }, "phone":function(){ // 5.0 版本之后,要实现二选一的验证效果,datatype 的名称 不 需要以 "option_" 开头; } }, usePlugin:{ swfupload:{}, datepicker:{}, passwordstrength:{}, jqtransform:{ selector:"select,input" } }, beforeCheck:function(curform){ //在表单提交执行验证之前执行的函数,curform参数是当前表单对象。 //这里明确return false的话将不会继续执行验证操作; }, beforeSubmit:function(curform){ //在验证成功后,表单提交前执行的函数,curform参数是当前表单对象。 //这里明确return false的话表单将不会提交; }, callback:function(data){ //返回数据data是json对象,{"info":"demo info","status":"y"} //info: 输出提示信息; //status: 返回提交数据的状态,是否提交成功。如可以用"y"表示提交成功,"n"表示提交失败,在ajax_post.php文件返回数据里自定字符,主要用在callback函数里根据该值执行相应的回调操作; //你也可以在ajax_post.php文件返回更多信息在这里获取,进行相应操作; //ajax遇到服务端错误时也会执行回调,这时的data是{ status:**, statusText:**, readyState:**, responseText:** }; //这里执行回调操作; //注意:如果不是ajax方式提交表单,传入callback,这时data参数是当前表单对象,回调函数会在表单验证全部通过后执行,然后判断是否提交表单,如果callback里明确return false,则表单不会提交,如果return true或没有return,则会提交表单。 } });
tiptype:function(msg,o,cssctl){ //msg:提示信息; //o:{obj:*,type:*,curform:*}, //obj指向的是当前验证的表单元素(或表单对象,验证全部验证通过,提交表单时o.obj为该表单对象), //type指示提示的状态,值为1、2、3、4, 1:正在检测/提交数据,2:通过验证,3:验证失败,4:提示ignore状态, //curform为当前form对象; //cssctl:内置的提示信息样式控制函数,该函数需传入两个参数:显示提示信息的对象 和 当前提示的状态(既形参o中的type); } 具体参见demo页。tiptype不为1时,Validform会查找class为"Validform_checktip"的标签显示提示信息。tiptype=1时,会自动创建弹出框显示提示信息。
datatyp:{ "zh2-4":/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/, "phone":function(gets,obj,curform,regxp){ //参数gets是获取到的表单元素值, //obj为当前表单元素, //curform为当前验证的表单, //regxp为内置的一些正则表达式的引用。 //return false表示验证出错,没有return或者return true表示验证通过。 } }具体示例请参考demo页;
如示例 var demo=$(".formsub").Validform(),那么demo对象会有以下属性和方法可以调用:
如:demo.tipmsg.s="error! no message inputed.";
通过该对象可以修改除 tit 以外的其他提示文字,这样可以实现同一个页面的不同表单使用不同的提示文字。
具体可修改的提示文字 $.Tipmsg={//默认提示文字; tit:"提示信息", w:{ "*":"不能为空!", "*6-16":"请填写6到16位任意字符!", "n":"请填写数字!", "n6-16":"请填写6到16位数字!", "s":"不能输入特殊字符!", "s6-18":"请填写6到18位字符!", "p":"请填写邮政编码!", "m":"请填写手机号码!", "e":"邮箱地址格式不对!", "url":"请填写网址!" }, def:"请填写正确信息!", undef:"datatype未定义!", reck:"两次输入的内容不一致!", r:"通过信息验证!", c:"正在检测信息…", s:"请{填写|选择}{0|信息}!", v:"所填信息没有经过验证,请稍后…", p:"正在提交数据…" };
要修改tit(弹出框的标题文字)的话,可以这样:$.Tipmsg.tit="Message Box",则弹出框的标题文字会换成"Message Box"
注:5.3.2+
$.Tipmsg.w里,形如"*6-16"的提示文字,里面的数字是会被替换的。如绑定datatype="*2-18",那它默认的出错信息就会是"请填写2到18位任意字符!",可以通过$.Tipmsg.w或Validform对象的tipmsg属性修改和扩展默认错误信息,如果你已经设置了"zh2-4"的提示信息是"2-4位中文",那么"zh2-8"出错的信息就自动会是:"2-8位中文"。对于自定义的datatype,在扩展默认信息时,注意错误信息的名字要跟datatype名字一样,如上面示例是:$.Tipmsg.w["zh2-4"]="2-4位中文"。对于多页面或一个页面多表单有相同datatype来说,在$.Tipmsg.w或Validform对象的tipmsg属性中扩展默认提示信息是个很好的选择。
5.3.1+
$.Tipmsg.s是用来指定在没有绑定nullmsg时的默认提示信息。"{0}"是会被找到的label参数指定的对象或Validform_label里的文字替换掉的,"{填写|选择}"里的文字在绑定了"recheck"属性的表单元素上检测时是会不显示的,当前验证对象是radio、checkbox或select时,会输出"选择",是其他类型的元素时会输出"填写"和后面的"信息"。
具体示例请参见demo页。
获取内置的一些正则:
{ "match":/^(.+?)(\d+)-(\d+)$/, "*":/[\w\W]+/, "*6-16":/^[\w\W]{6,16}$/, "n":/^\d+$/, "n6-16":/^\d{6,16}$/, "s":/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]+$/, "s6-18":/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]{6,18}$/, "p":/^[0-9]{6}$/, "m":/^13[0-9]{9}$|14[0-9]{9}|15[0-9]{9}$|18[0-9]{9}$/, "e":/^\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$/, "url":/^(\w+:\/\/)?\w+(\.\w+)+.*$/ }
可以通过Validform对象的这个方法来给表单元素绑定验证规则,绑定验证类型中列出的附加属性都可以通过这个方法绑定。
demo.addRule([ { ele:"#name", datatype:"s6-18", ajaxurl:"valid.php", nullmsg:"请输入昵称!", errormsg:"昵称至少6个字符,最多18个字符!" }, { ele:"#userpassword", datatype:"*6-16", nullmsg:"请设置密码!", errormsg:"密码范围在6~16位之间!" }, { ele:"#userpassword2", datatype:"*", recheck:"userpassword", nullmsg:"请再输入一次密码!", errormsg:"您两次输入的账号密码不一致!" } ]);
其中ele是指定要绑定规则的对象,会在Validform对象下查找这些对象。
获取Validform对象的第n个元素。
如你页面上有多个form的class都是formsub,执行上面的验证绑定,得到的demo对象就可以操作所有这些表单,如果你要对其中某个表单执行某些操作,那么就可以使用这个方法。
如demo.eq(0).resetForm(),重置第一个表单。
以ajax方式提交表单。flag为true时,跳过验证直接提交,sync为true时将以同步的方式进行ajax提交。
参数url是5.3版新增,传入了url地址时,表单会提交到这个地址
如demo.ajaxPost(true),不做验证直接ajax提交表单。
终止ajax的提交。
如执行上面的ajaxPost()之后,发现某些项填写不对,想取消表单提交,那么就可以执行这个操作:demo.abort()
以初始化时传入参数的设置方式提交表单,flag为true时,跳过验证直接提交。
参数url是5.3版新增,传入了url地址时,表单会提交到这个地址
如demo.submitForm(true),不做验证直接提交表单。
重置表单。
如demo.resetForm(),重置表单到初始状态。
重置表单的提交状态。传入了postonce参数的话,表单成功提交后状态会设置为"posted",重置提交状态可以让表单继续可以提交。
如demo.resetStatus()
获取表单的提交状态,normal:未提交,posting:正在提交,posted:已成功提交过。
如demo.getStatus()
设置表单的提交状态,可以设置normal,posting,posted三种状态,不传参则设置状态为posting,这个状态表单可以验证,但不能提交。
如demo.setStatus("posted")
忽略对所选择对象的验证,不传入selector则忽略所有表单元素。
如demo.ignore("select,textarea,#name"),忽略Validform对象下所有select,textarea及一个id为"name"元素的验证。
将ignore方法所忽略验证的对象重新获取验证效果,不传入selector则恢复验证所有表单元素。
如demo.unignore("select,textarea,#name"),恢复Validform对象下所有select,textarea及一个id为"name"元素的验证。
bool为true时则只验证不显示提示信息
对指定对象进行验证(默认验证当前整个表单),通过返回true,否则返回false(绑定实时验证的对象,格式符合要求时返回true,而不会等ajax的返回结果)
如demo.check(),验证当前整个表单,且只验证但不显示对错信息。
setup参数是一个对象。
如: demo.config({ showAllError:true, url:"这里指定提交地址", ajaxpost:{ //可以传入$.ajax()能使用的,除dataType外的所有参数; }, ajaxurl:{ //可以传入$.ajax()能使用的,除dataType外的所有参数; } }) 可用参数: tiptype等 5.3.2+:可以在这里设置初始化可用的所有参数 url:指定表单的提交路径,这里指定的路径会覆盖表单action属性所指定的路径 ajaxpost:表单以ajax提交时,可以在这里配置ajax的参数 ajaxurl:配置实时验证ajax的参数 ①、config方法还能为已经初始化过的表单重新配置参数了!5.3.2+ 如var demo=$(".formsub").Validform(); demo.config({tiptype:2}); demo下的各表单还能分别配置不同参数! 如demo.eq(0).config({tiptype:1,ajaxPost:true}); demo.eq(1).config({tiptype:1,callback:function(curform){my_method_to_submit_form(); return false;}}); ②、执行config可以动态设置、添加参数,如: demo.config({ url:"http://validform.rjboy.cn" }); $(".save").click(function(){ demo.config({ ajaxpost:{ timeout:1000 } }); }); 那么在点击save按钮后,demo所对应的表单的config={ url:"http://validform.rjboy.cn", ajaxpost:{ timeout:1000 } } ③、参数url的优先级:form表单的action所指定的提交地址会被config.url覆盖, config.url会被config.ajaxpost.url覆盖,config.ajaxpost.url会被Validform对象的方法submitForm(flag,url) 和ajaxPost(flag,sync,url)里的url覆盖。 如果表单里没有指定action提交地址,那么就会提交到config.url设定的地址。 考虑到整个验证框架的逻辑,传入dataType参数不会起作用,不会被覆盖,ajax必须返回含有status值的json数据。 ④、另外注意的是:传入的success和error方法里,能多获取到一个参数,如: demo.config={ ajaxpost:{ url:"", timeout:1000, ..., success:function(data,obj){ //data是返回的json数据; //obj是当前表单的jquery对象; }, error:function(data,obj){ //data是{ status:**, statusText:**, readyState:**, responseText:** }; //obj是当前表单的jquery对象; } }, ajaxurl:{ success:function(data,obj){ //data是返回的json数据; //obj是当前正做实时验证表单元素的jquery对象; //注意:5.3版中,实时验证的返回数据须是含有status值的json数据! //跟callback里的ajax返回数据格式统一,建议不再返回字符串"y"或"n"。目前这两种格式的数据都兼容。 } } }
选择文件后立即上传
表单验证通过后上传文件
密码强度提示与验证提示同时显示
在符合验证要求时才有密码强度提示
默认效果
选择日期后执行回调函数
默认对所有元素美化
美化指定的表单元素
可以通过$.Datatype对象来扩展datatype类型。
如$.Datatype.zh=/^[\u4E00-\u9FA5\uf900-\ufa2d]{1,}$/
可以通过$.Tipmsg对象来修改默认提示文字。具体可修改的提示文字请查看Validform对象的tipmsg属性。
如果Validform对象的tipmsg属性没有找到相关的提示信息,那么就会到$.Tipmsg中查找对应提示文字。
如$.Tipmsg.tit="msg box"; //设置默认弹出框的标题文字。
调用Validform自定义的弹出框。
参数msg是要显示的提示文字。
如$.Showmsg("这是提示文字"); //如果不传入信息则不会有弹出框出现,像$.Showmsg()这样是不会弹出提示框的。
关闭Validform自定义的弹出框。
如$.Hidemsg()
参考:http://www.360doc.com/content/14/0923/12/21412_411713803.shtml