<p>1、引入css</p><p>请查看下载文件中的style.css,把里面Validform必须部分复制到你的css中(文件里这个注释 &quot;/*==========以下部分是Validform必须的===========*/&quot; 之后的部分是必须的)。之前发现有部分网友把整个style.css都引用在了页面里,然后发现样式冲突了。</p><p>2、引入js (jquery 1.4.3 以上版本都可以)</p><p>&lt;script type=&quot;text/javascript&quot; src=&quot;http://validform.rjboy.cn/wp-content/themes/validform/js/jquery-1.6.2.min.js&quot;&gt;&lt;/script&gt;</p><p>&lt;script type=&quot;text/javascript&quot; src=&quot;http://validform.rjboy.cn/Validform/v5.1/Validform_v5.1_min.js&quot;&gt;&lt;/script&gt;</p><p>3、给需要验证的表单元素绑定附加属性</p><p>&lt;form class=&quot;demoform&quot;&gt;</p><p>&lt;input type=&quot;text&quot; value=&quot;&quot; name=&quot;name&quot; datatype=&quot;s5-16&quot; errormsg=&quot;昵称至少5个字符,最多16个字符!&quot; /&gt;</p><p>&lt;/form&gt;</p><p>4、初始化,就这么简单</p><p>$(&quot;.demoform&quot;).Validform();</p><p>注:</p><p>1、Validform有非压缩、压缩和NCR三个版本提供下载,NCR是通用版,当你页面因编码问题,提示文字出现乱码时可以使用这个版本;</p><p>2、Validform没有限定必须使用table结构,它可以适用于任何结构,需要在tiptype中定义好位置关系。</p><p>绑定附加属性</p><p>凡要验证格式的元素均需绑定datatype属性,datatype可选值内置有10类,用来指定不同的验证格式。</p><p>如果还不能满足您的验证需求,可以传入自定义datatype,自定义datatype是一个非常强大的功能,通过它可以满足你的任何需求。</p><p>可以绑定的附加属性有:datatype、nullmsg、sucmsg、errormsg、ignore、recheck、tip、altercss、ajaxurl 和 plugin</p><p>绑定方法如下所示:</p><p>&lt;!--ajax实时验证用户名--&gt;</p><p>&lt;input type=&quot;text&quot; value=&quot;&quot; name=&quot;name&quot; datatype=&quot;e&quot; ajaxurl=&quot;valid.php?myparam1=value1&amp;myparam2=value2&quot; sucmsg=&quot;用户名验证通过!&quot; nullmsg=&quot;请输入用户名!&quot; errormsg=&quot;请用邮箱或手机号码注册!&quot; /&gt;</p><p></p><p>&lt;!--密码--&gt;</p><p>&lt;input type=&quot;password&quot; value=&quot;&quot; name=&quot;userpassword&quot; datatype=&quot;*6-15&quot; errormsg=&quot;密码范围在6~15位之间!&quot; /&gt;</p><p>&lt;!--确认密码--&gt;</p><p>&lt;input type=&quot;password&quot; value=&quot;&quot; name=&quot;userpassword2&quot; datatype=&quot;*&quot; recheck=&quot;userpassword&quot; errormsg=&quot;您两次输入的账号密码不一致!&quot; /&gt;</p><p></p><p>&lt;!--默认提示文字--&gt;</p><p>&lt;textarea tip=&quot;请在这里输入您的意见。&quot; errormsg=&quot;很感谢您花费宝贵时间给我们提供反馈,请填写有效内容!&quot; datatype=&quot;s&quot; altercss=&quot;gray&quot; class=&quot;gray&quot; name=&quot;msg&quot; value=&quot;&quot;&gt;请在这里输入您的意见。&lt;/textarea&gt;</p><p></p><p>&lt;!--使用swfupload插件--&gt;</p><p>&lt;input type=&quot;text&quot; plugin=&quot;swfupload&quot; class=&quot;inputxt&quot; disabled=&quot;disabled&quot; value=&quot;&quot;&gt;</p><p>&lt;input type=&quot;hidden&quot; value=&quot;&quot; pluginhidden=&quot;swfupload&quot;&gt;</p><p></p><p>&lt;!--使用passwordStrength插件--&gt;</p><p>&lt;input type=&quot;password&quot; errormsg=&quot;密码至少6个字符,最多18个字符!&quot; datatype=&quot;*6-18&quot; plugin=&quot;passwordStrength&quot; class=&quot;inputxt&quot; name=&quot;password&quot; value=&quot;&quot;&gt;</p><p>&lt;div class=&quot;passwordStrength&quot; style=&quot;display:none;&quot;&gt;&lt;b&gt;密码强度:&lt;/b&gt; &lt;span&gt;弱&lt;/span&gt;&lt;span&gt;中&lt;/span&gt;&lt;span class=&quot;last&quot;&gt;强&lt;/span&gt;&lt;/div&gt;</p><p></p><p>&lt;!--使用DatePicker插件--&gt;</p><p>&lt;input type=&quot;text&quot; plugin=&quot;datepicker&quot; class=&quot;inputxt&quot; name=&quot;birthday&quot; value=&quot;&quot;&gt;</p><p>说明:</p><p>datatype</p><p>内置基本的datatype类型有: * | *6-16 | n | n6-16 | s | s6-18 | p | m | e | url</p><p>*:检测是否有输入,可以输入任何字符,不留空即可通过验证;</p><p>*6-16:检测是否为6到16位任意字符;</p><p>n:数字类型;</p><p>n6-16:6到16位数字;</p><p>s:字符串类型;</p><p>s6-18:6到18位字符串;</p><p>p:验证是否为邮政编码;</p><p>m:手机号码格式;</p><p>e:email格式;</p><p>url:验证字符串是否为网址。</p><p>自定义datatype的名称,可以由字母、数字、下划线、中划线和*号组成。</p><p>形如&quot;*6-16&quot;的datatype,Validform会自动扩展,可以指定任意的数值范围。如内置基本类型有&quot;*6-16&quot;,那么你绑定datatype=&quot;*4-12&quot;就表示4到12位任意字符。如果你自定义了一个datatype=&quot;zh2-4&quot;,表示2到4位中文字符,那么datatype=&quot;zh2-6&quot;就表示2到6位中文字符。</p><p>5.2版本之后,datatype支持规则累加或单选。用&quot;,&quot;分隔表示规则累加;用&quot;|&quot;分隔表示规则多选一,即只要符合其中一个规则就可以通过验证,绑定的规则会依次验证,只要验证通过,后面的规则就会忽略不再比较。如绑定datatype=&quot;m|e&quot;,表示既可以填写手机号码,也能填写邮箱地址,如果知道填入的是手机号码,那么就不会再检测他是不是邮箱地址;datatype=&quot;zh,s2-4&quot;,表示要符合自定义类型&quot;zh&quot;,也要符合规则&quot;s2-4&quot;。</p><p>注:</p><p>5.2.1版本之后,datatype支持:</p><p>直接绑定正则:如可用这样写datatype=&quot;/\w{3,6}/i&quot;,要求是3到6位的字母,不区分大小写;</p><p>支持简单的逻辑运算:如datatype=&quot;m | e, *4-18 | /\w{3,6}/i | /^validform\.rjboy\.cn$/&quot;,</p><p>这个表达式的意思是:可以是手机号码;或者是邮箱地址,但字符长度必须在4到18位;或者是3到6位的字母,不区分大小写;或者输入validform.rjboy.cn,区分大小写。这里&quot;,&quot;分隔相当于逻辑运算里的&quot;&amp;&amp;&quot;; &quot;|&quot;分隔相当于逻辑运算里的&quot;||&quot;;不支持括号运算。</p><p>nullmsg</p><p>当表单元素值为空时的提示信息,不绑定,默认提示&quot;请填入信息!&quot;。</p><p>如:nullmsg=&quot;请填写用户名!&quot;</p><p>5.3版开始,对于没有绑定nullmsg的对象,会自动查找class为Validform_label下的文字作为提示文字:</p><p>如这样的html结构:</p><p>&lt;span class=&quot;Validform_label&quot;&gt;*用户名:&lt;/span&gt;&lt;input type=&quot;text&quot; val=&quot;&quot; datatype=&quot;s&quot; /&gt;</p><p>当这个文本框里没有输入时的出错信息就会是:&quot;请输入用户名!&quot;</p><p>这里Validform_label跟input之间的位置关系,不一定是要同级关系,同级里没有找到的话,它还会在同级的子级、父级的同级、父级的同级的子级里查找。</p><p>sucmsg 5.3+</p><p>当表单元素通过验证时的提示信息,不绑定,默认提示&quot;通过信息验证!&quot;。</p><p>如:sucmsg=&quot;用户名还未被使用,可以注册!&quot;</p><p>5.3版开始,也可以在实时验证返回的json数据里返回成功的提示文字,请查看附加属性ajaxurl的介绍。</p><p>errormsg</p><p>输入内容不能通过验证时的提示信息,默认提示&quot;请输入正确信息!&quot;。</p><p>如:errormsg=&quot;用户名必须是2到4位中文字符!&quot;</p><p>5.3版开始,Validform可以根据你绑定的datatype智能的输出相应出错信息,具体介绍请查看tipmsg</p><p>ignore</p><p>绑定了ignore=&quot;ignore&quot;的表单元素,在有输入时,会验证所填数据是否符合datatype所指定数据类型,</p><p>没有填写内容时则会忽略对它的验证;</p><p>recheck</p><p>表单里面经常需要检查两次密码输入是否一致,recheck就是用来指定需要比较的另外一个表单元素。</p><p>如:recheck=&quot;password1&quot;,那么它就会拿当前元素的值跟该表单下,name为&quot;password1&quot;的元素比较。</p><p>tip</p><p>表单里经常有些文本框需要默认就显示一个灰色的提示文字,当获得焦点时提示文字消失,失去焦点时提示文字显示。tip属性就是用来实现这个效果。它通常和altercss搭配使用。</p><p>如&lt;input type=&quot;text&quot; value=&quot;默认提示文字&quot; class=&quot;gray intxt&quot; tip=&quot;默认提示文字&quot; altercss=&quot;gray&quot; /&gt;</p><p>altercss</p><p>它需要和tip属性配合使用,altercss指定的样式名,会在文本框获得焦点时被删除,没有输入内容而失去焦点时重新加上。</p><p>ajaxurl</p><p>指定ajax实时验证的后台文件的地址。</p><p>后台页面如valid.php文件中可以用 $_POST[&quot;param&quot;] 接收到值,Ajax中会POST过来变量param和name。param是文本框的值,name是文本框的name属性。</p><p>5.2版本开始,可以在ajaxurl指定的url后绑定参数,如:ajaxurl=&quot;valid.php?myparam1=value1&amp;myparam2=value2&quot;; 5.3.1开始,地址后面附带的参数内部不再做另外解析,仍附带在地址后面,所以需要用GET方式去获取地址后面带的参数。</p><p>5.3之前的版本中,该文件输出的字符会作为错误信息显示在页面上,如果验证通过需输出小写字母&quot;y&quot;。</p><p>在5.3版中,实时验证的返回数据做了调整,须是含有status值的json数据!跟callback里的ajax返回数据格式统一,建议不再返回字符串&quot;y&quot;或&quot;n&quot;。目前这两种格式的数据都兼容。</p><p>注:</p><p>如果ajax校验通过,会在该元素上绑定validform_valid值为true。可以通过设置该值来控制验证能不能通过,如验证码的验证,第一次验证通过后,不小心右点击了下验证码图片,验证码换了,但是仍然指示这个对象已经通过了验证,这时可以手动调整该值:$(&quot;#name&quot;)[0].validform_valid=&quot;false&quot;。</p><p>怎样设置ajax的参数,具体可以查看Validform对象的config方法。</p><p>plugin</p><p>指定需要使用的插件。</p><p>5.3版开始,对于日期、swfupload和密码强度检测这三个插件,绑定了plugin属性即可以初始化对应的插件,可以不用在validform初始化时传入空的usePlugin了。</p><p>如,你要使用日期插件,5.3之前版本需要这样初始化:</p><p>$(&quot;.demoform&quot;).Validform({</p><p> usePlugin:{</p><p> <span class="Apple-tab-span" > </span>datepicker:{}</p><p> }</p><p>});</p><p>5.3版开始,不需要传入这些空对象了,只需在表单元素上绑定plugin=&quot;datepicker&quot;就可以,初始化直接这样:</p><p>$(&quot;.demoform&quot;).Validform();</p><p>初始化参数说明</p><p>所有可用参数如下:</p><p>$(&quot;.demoform&quot;).Validform({</p><p><span class="Apple-tab-span" > </span>btnSubmit:&quot;#btn_sub&quot;,</p><p><span class="Apple-tab-span" > </span>btnReset:&quot;.btn_reset&quot;,</p><p><span class="Apple-tab-span" > </span>tiptype:1,</p><p><span class="Apple-tab-span" > </span>ignoreHidden:false,</p><p><span class="Apple-tab-span" > </span>dragonfly:false,</p><p><span class="Apple-tab-span" > </span>tipSweep:true,</p><p><span class="Apple-tab-span" > </span>label:&quot;.label&quot;,</p><p><span class="Apple-tab-span" > </span>showAllError:false,</p><p><span class="Apple-tab-span" > </span>postonce:true,</p><p><span class="Apple-tab-span" > </span>ajaxPost:true,</p><p><span class="Apple-tab-span" > </span>datatype:{</p><p><span class="Apple-tab-span" > </span>&quot;*6-20&quot;: /^[^\s]{6,20}$/,</p><p><span class="Apple-tab-span" > </span>&quot;z2-4&quot; : /^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/,</p><p><span class="Apple-tab-span" > </span>&quot;username&quot;:function(gets,obj,curform,regxp){</p><p><span class="Apple-tab-span" > </span>//参数gets是获取到的表单元素值,obj为当前表单元素,curform为当前验证的表单,regxp为内置的一些正则表达式的引用;</p><p><span class="Apple-tab-span" > </span>var reg1=/^[\w\.]{4,16}$/,</p><p><span class="Apple-tab-span" > </span>reg2=/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,8}$/;</p><p></p><p><span class="Apple-tab-span" > </span>if(reg1.test(gets)){return true;}</p><p><span class="Apple-tab-span" > </span>if(reg2.test(gets)){return true;}</p><p><span class="Apple-tab-span" > </span>return false;</p><p></p><p><span class="Apple-tab-span" > </span>//注意return可以返回true 或 false 或 字符串文字,true表示验证通过,返回字符串表示验证失败,字符串作为错误提示显示,返回false则用errmsg或默认的错误提示;</p><p><span class="Apple-tab-span" > </span>},</p><p><span class="Apple-tab-span" > </span>&quot;phone&quot;:function(){</p><p><span class="Apple-tab-span" > </span>// 5.0 版本之后,要实现二选一的验证效果,datatype 的名称 不 需要以 &quot;option_&quot; 开头;<span class="Apple-tab-span" > </span></p><p><span class="Apple-tab-span" > </span>}</p><p><span class="Apple-tab-span" > </span>},</p><p><span class="Apple-tab-span" > </span>usePlugin:{</p><p><span class="Apple-tab-span" > </span>swfupload:{},</p><p><span class="Apple-tab-span" > </span>datepicker:{},</p><p><span class="Apple-tab-span" > </span>passwordstrength:{},</p><p><span class="Apple-tab-span" > </span>jqtransform:{</p><p><span class="Apple-tab-span" > </span>selector:&quot;select,input&quot;</p><p><span class="Apple-tab-span" > </span>}</p><p><span class="Apple-tab-span" > </span>},</p><p><span class="Apple-tab-span" > </span>beforeCheck:function(curform){</p><p><span class="Apple-tab-span" > </span>//在表单提交执行验证之前执行的函数,curform参数是当前表单对象。</p><p><span class="Apple-tab-span" > </span>//这里明确return false的话将不会继续执行验证操作;<span class="Apple-tab-span" > </span></p><p><span class="Apple-tab-span" > </span>},</p><p><span class="Apple-tab-span" > </span>beforeSubmit:function(curform){</p><p><span class="Apple-tab-span" > </span>//在验证成功后,表单提交前执行的函数,curform参数是当前表单对象。</p><p><span class="Apple-tab-span" > </span>//这里明确return false的话表单将不会提交;<span class="Apple-tab-span" > </span></p><p><span class="Apple-tab-span" > </span>},</p><p><span class="Apple-tab-span" > </span>callback:function(data){</p><p><span class="Apple-tab-span" > </span>//返回数据data是json对象,{&quot;info&quot;:&quot;demo info&quot;,&quot;status&quot;:&quot;y&quot;}</p><p><span class="Apple-tab-span" > </span>//info: 输出提示信息;</p><p><span class="Apple-tab-span" > </span>//status: 返回提交数据的状态,是否提交成功。如可以用&quot;y&quot;表示提交成功,&quot;n&quot;表示提交失败,在ajax_post.php文件返回数据里自定字符,主要用在callback函数里根据该值执行相应的回调操作;</p><p><span class="Apple-tab-span" > </span>//你也可以在ajax_post.php文件返回更多信息在这里获取,进行相应操作;</p><p><span class="Apple-tab-span" > </span>//ajax遇到服务端错误时也会执行回调,这时的data是{ status:**, statusText:**, readyState:**, responseText:** };</p><p></p><p><span class="Apple-tab-span" > </span>//这里执行回调操作;</p><p><span class="Apple-tab-span" > </span>//注意:如果不是ajax方式提交表单,传入callback,这时data参数是当前表单对象,回调函数会在表单验证全部通过后执行,然后判断是否提交表单,如果callback里明确return false,则表单不会提交,如果return true或没有return,则会提交表单。</p><p><span class="Apple-tab-span" > </span>}</p><p>});</p><p>参数说明:【所有参数均为可选项】</p><p>必须是表单对象执行Validform方法,示例中&quot;.demoform&quot;就是绑定在form元素上的class名称;</p><p>btnSubmit</p><p>指定当前表单下的哪一个按钮触发表单提交事件,如果表单下有submit按钮时可以省略该参数。示例中&quot;.btn_sub&quot;是该表单下要绑定点击提交表单事件的按钮;</p><p>btnReset</p><p>&quot;.btn_reset&quot;是该表单下要绑定点击重置表单事件的按钮;</p><p>tiptype</p><p>可用的值有:1、2、3、4和function函数,默认tiptype为1。 3、4是5.2.1版本新增</p><p>1=&gt; 自定义弹出框提示;</p><p>2=&gt; 侧边提示(会在当前元素的父级的next对象的子级查找显示提示信息的对象,表单以ajax提交时会弹出自定义提示框显示表单提交状态);</p><p>3=&gt; 侧边提示(会在当前元素的siblings对象中查找显示提示信息的对象,表单以ajax提交时会弹出自定义提示框显示表单提交状态);</p><p>4=&gt; 侧边提示(会在当前元素的父级的next对象下查找显示提示信息的对象,表单以ajax提交时不显示表单的提交状态);</p><p>如果上面的4种提示方式不是你需要的,你可以给tiptype传入自定义函数。通过自定义函数,可以实现你想要的任何提示效果:</p><p>tiptype:function(msg,o,cssctl){</p><p> //msg:提示信息;</p><p> //o:{obj:*,type:*,curform:*},</p><p> //obj指向的是当前验证的表单元素(或表单对象,验证全部验证通过,提交表单时o.obj为该表单对象),</p><p> //type指示提示的状态,值为1、2、3、4, 1:正在检测/提交数据,2:通过验证,3:验证失败,4:提示ignore状态,</p><p> //curform为当前form对象;</p><p> //cssctl:内置的提示信息样式控制函数,该函数需传入两个参数:显示提示信息的对象 和 当前提示的状态(既形参o中的type);</p><p>}</p><p>具体参见demo页。</p><p>tiptype不为1时,Validform会查找class为&quot;Validform_checktip&quot;的标签显示提示信息。tiptype=1时,会自动创建弹出框显示提示信息。</p><p>Validform_checktip和表单元素之间的位置关系,会根据tiptype的值有对应的结构,上面已经做了说明。</p><p>5.3版本开始,如果页面里没有显示出错信息的标签,会根据tiptype值自动创建Validform_checktip对象。</p><p>ignoreHidden</p><p>可用值: true | false。</p><p>默认为false,当为true时对:hidden的表单元素将不做验证;</p><p>dragonfly</p><p>可用值: true | false。</p><p>默认false,当为true时,值为空时不做验证;</p><p>tipSweep</p><p>可用值: true | false。</p><p>默认为false, 5.3版中做了修正,在各种tiptype下, 为true时提示信息将只会在表单提交时触发显示,各表单元素blur时不会触发信息提示;</p><p>label 5.3.1+</p><p>选择符</p><p>在没有绑定nullmsg时查找要显示的提示文字,默认查找&quot;.Validform_label&quot;下的文字;</p><p>showAllError</p><p>可用值: true | false。</p><p>默认为false,true:提交表单时所有错误提示信息都会显示;false:一碰到验证不通过的对象就会停止检测后面的元素,只显示该元素的错误信息;</p><p>postonce</p><p>可用值: true | false。</p><p>默认为false,指定是否开启二次提交防御,true开启,不指定则默认关闭;</p><p>为true时,在数据成功提交后,表单将不能再继续提交。</p><p>ajaxPost</p><p>可用值: true | false。</p><p>默认为false,使用ajax方式提交表单数据,将会把数据POST到config方法或表单action属性里设定的地址;</p><p>datatype</p><p>传入自定义datatype类型,可以是正则,也可以是函数。</p><p>datatyp:{</p><p> &quot;zh2-4&quot;:/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/,</p><p> &quot;phone&quot;:function(gets,obj,curform,regxp){</p><p> //参数gets是获取到的表单元素值,</p><p> //obj为当前表单元素,</p><p> //curform为当前验证的表单,</p><p> //regxp为内置的一些正则表达式的引用。</p><p> </p><p> //return false表示验证出错,没有return或者return true表示验证通过。</p><p> }</p><p>}</p><p>具体示例请参考demo页;</p><p>usePlugin</p><p>目前已整合swfupload、datepicker、passwordstrength和jqtransform四个插件,在这里传入这些插件使用时需要传入的参数。datepicker在Validform内调用时另外扩展了几个比较实用的参数,具体请参考demo页;</p><p>beforeCheck(curform)</p><p>在表单提交执行验证之前执行的函数,curform参数获取到的是当前表单对象。</p><p>函数return false的话将不会继续执行验证操作;</p><p>beforeSubmit(curform)</p><p>在表单验证通过,提交表单数据之前执行的函数,data参数是当前表单对象。</p><p>函数return false的话表单将不会提交;</p><p>callback</p><p>在使用ajax提交表单数据时,数据提交后的回调函数。返回数据data是Json对象:</p><p>{&quot;info&quot;:&quot;demo info&quot;,&quot;status&quot;:&quot;y&quot;}</p><p>info: 输出提示信息,</p><p>status: 返回提交数据的状态,是否提交成功,&quot;y&quot;表示提交成功,&quot;n&quot;表示提交失败,在ajax_post.php文件返回数据里自定字符,主要用在callback函数里根据该值执行相应的回调操作。你也可以在ajax_post.php文件返回更多信息在这里获取,进行相应操作;</p><p>如果不是ajax方式提交表单,传入callback,这时data参数是当前表单对象,回调函数会在表单验证全部通过后执行,然后判断是否提交表单,如果callback里return false,则表单不会提交,如果return true或没有return,则会提交表单。</p><p>5.3版开始,ajax遇到服务端错误时也会执行回调,这时的data是{ status:**, statusText:**, readyState:**, responseText:** }</p><p>Validform对象[方法支持链式调用]</p><p>如示例 var demo=$(&quot;.formsub&quot;).Validform(),那么demo对象会有以下属性和方法可以调用:</p><p>tipmsg【object】</p><p>如:demo.tipmsg.s=&quot;error! no message inputed.&quot;;</p><p>通过该对象可以修改除 tit 以外的其他提示文字,这样可以实现同一个页面的不同表单使用不同的提示文字。</p><p>具体可修改的提示文字</p><p>$.Tipmsg={//默认提示文字;</p><p>tit:&quot;提示信息&quot;,</p><p>w:{</p><p> &quot;*&quot;:&quot;不能为空!&quot;,</p><p> &quot;*6-16&quot;:&quot;请填写6到16位任意字符!&quot;,</p><p> &quot;n&quot;:&quot;请填写数字!&quot;,</p><p> &quot;n6-16&quot;:&quot;请填写6到16位数字!&quot;,</p><p> &quot;s&quot;:&quot;不能输入特殊字符!&quot;,</p><p> &quot;s6-18&quot;:&quot;请填写6到18位字符!&quot;,</p><p> &quot;p&quot;:&quot;请填写邮政编码!&quot;,</p><p> &quot;m&quot;:&quot;请填写手机号码!&quot;,</p><p> &quot;e&quot;:&quot;邮箱地址格式不对!&quot;,</p><p> &quot;url&quot;:&quot;请填写网址!&quot;</p><p>},</p><p>def:&quot;请填写正确信息!&quot;,</p><p>undef:&quot;datatype未定义!&quot;,</p><p>reck:&quot;两次输入的内容不一致!&quot;,</p><p>r:&quot;通过信息验证!&quot;,</p><p>c:&quot;正在检测信息…&quot;,</p><p>s:&quot;请{填写|选择}{0|信息}!&quot;,</p><p>v:&quot;所填信息没有经过验证,请稍后…&quot;,</p><p>p:&quot;正在提交数据…&quot;</p><p>};</p><p>要修改tit(弹出框的标题文字)的话,可以这样:$.Tipmsg.tit=&quot;Message Box&quot;,则弹出框的标题文字会换成&quot;Message Box&quot;</p><p>注:5.3.2+</p><p>$.Tipmsg.w里,形如&quot;*6-16&quot;的提示文字,里面的数字是会被替换的。如绑定datatype=&quot;*2-18&quot;,那它默认的出错信息就会是&quot;请填写2到18位任意字符!&quot;,可以通过$.Tipmsg.w或Validform对象的tipmsg属性修改和扩展默认错误信息,如果你已经设置了&quot;zh2-4&quot;的提示信息是&quot;2-4位中文&quot;,那么&quot;zh2-8&quot;出错的信息就自动会是:&quot;2-8位中文&quot;。对于自定义的datatype,在扩展默认信息时,注意错误信息的名字要跟datatype名字一样,如上面示例是:$.Tipmsg.w[&quot;zh2-4&quot;]=&quot;2-4位中文&quot;。对于多页面或一个页面多表单有相同datatype来说,在$.Tipmsg.w或Validform对象的tipmsg属性中扩展默认提示信息是个很好的选择。</p><p>5.3.1+</p><p>$.Tipmsg.s是用来指定在没有绑定nullmsg时的默认提示信息。&quot;{0}&quot;是会被找到的label参数指定的对象或Validform_label里的文字替换掉的,&quot;{填写|选择}&quot;里的文字在绑定了&quot;recheck&quot;属性的表单元素上检测时是会不显示的,当前验证对象是radio、checkbox或select时,会输出&quot;选择&quot;,是其他类型的元素时会输出&quot;填写&quot;和后面的&quot;信息&quot;。</p><p>具体示例请参见demo页。</p><p>dataType【object】</p><p>获取内置的一些正则:</p><p>{</p><p> &quot;match&quot;:/^(.+?)(\d+)-(\d+)$/,</p><p> &quot;*&quot;:/[\w\W]+/,</p><p> &quot;*6-16&quot;:/^[\w\W]{6,16}$/,</p><p> &quot;n&quot;:/^\d+$/,</p><p> &quot;n6-16&quot;:/^\d{6,16}$/,</p><p> &quot;s&quot;:/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]+$/,</p><p> &quot;s6-18&quot;:/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]{6,18}$/,</p><p> &quot;p&quot;:/^[0-9]{6}$/,</p><p> &quot;m&quot;:/^13[0-9]{9}$|14[0-9]{9}|15[0-9]{9}$|18[0-9]{9}$/,</p><p> &quot;e&quot;:/^\w+([-+.&#39;]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$/,</p><p> &quot;url&quot;:/^(\w+:\/\/)?\w+(\.\w+)+.*$/</p><p>}</p><p>addRule(rule)【返回值:Validform】</p><p>可以通过Validform对象的这个方法来给表单元素绑定验证规则,绑定验证类型中列出的附加属性都可以通过这个方法绑定。</p><p>demo.addRule([</p><p> {</p><p> ele:&quot;#name&quot;,</p><p> datatype:&quot;s6-18&quot;,</p><p> ajaxurl:&quot;valid.php&quot;,</p><p> nullmsg:&quot;请输入昵称!&quot;,</p><p> errormsg:&quot;昵称至少6个字符,最多18个字符!&quot;</p><p> },</p><p> {</p><p> ele:&quot;#userpassword&quot;,</p><p> datatype:&quot;*6-16&quot;,</p><p> nullmsg:&quot;请设置密码!&quot;,</p><p> errormsg:&quot;密码范围在6~16位之间!&quot;</p><p> },</p><p> {</p><p> ele:&quot;#userpassword2&quot;,</p><p> datatype:&quot;*&quot;,</p><p> recheck:&quot;userpassword&quot;,</p><p> nullmsg:&quot;请再输入一次密码!&quot;,</p><p> errormsg:&quot;您两次输入的账号密码不一致!&quot;</p><p> }</p><p>]);</p><p>其中ele是指定要绑定规则的对象,会在Validform对象下查找这些对象。</p><p>eq(n)【返回值:Validform】</p><p>获取Validform对象的第n个元素。</p><p>如你页面上有多个form的class都是formsub,执行上面的验证绑定,得到的demo对象就可以操作所有这些表单,如果你要对其中某个表单执行某些操作,那么就可以使用这个方法。</p><p>如demo.eq(0).resetForm(),重置第一个表单。</p><p>ajaxPost(flag,sync,url)【返回值:Validform】</p><p>以ajax方式提交表单。flag为true时,跳过验证直接提交,sync为true时将以同步的方式进行ajax提交。</p><p>参数url是5.3版新增,传入了url地址时,表单会提交到这个地址</p><p>如demo.ajaxPost(true),不做验证直接ajax提交表单。</p><p>abort()【返回值:Validform】</p><p>终止ajax的提交。</p><p>如执行上面的ajaxPost()之后,发现某些项填写不对,想取消表单提交,那么就可以执行这个操作:demo.abort()</p><p>submitForm(flag,url)【返回值:Validform】</p><p>以初始化时传入参数的设置方式提交表单,flag为true时,跳过验证直接提交。</p><p>参数url是5.3版新增,传入了url地址时,表单会提交到这个地址</p><p>如demo.submitForm(true),不做验证直接提交表单。</p><p>resetForm()【返回值:Validform】</p><p>重置表单。</p><p>如demo.resetForm(),重置表单到初始状态。</p><p>resetStatus()【返回值:Validform】</p><p>重置表单的提交状态。传入了postonce参数的话,表单成功提交后状态会设置为&quot;posted&quot;,重置提交状态可以让表单继续可以提交。</p><p>如demo.resetStatus()</p><p>getStatus()【返回值:String】</p><p>获取表单的提交状态,normal:未提交,posting:正在提交,posted:已成功提交过。</p><p>如demo.getStatus()</p><p>setStatus(status)【返回值:Validform】</p><p>设置表单的提交状态,可以设置normal,posting,posted三种状态,不传参则设置状态为posting,这个状态表单可以验证,但不能提交。</p><p>如demo.setStatus(&quot;posted&quot;)</p><p>ignore(selector)【返回值:Validform】</p><p>忽略对所选择对象的验证,不传入selector则忽略所有表单元素。</p><p>如demo.ignore(&quot;select,textarea,#name&quot;),忽略Validform对象下所有select,textarea及一个id为&quot;name&quot;元素的验证。</p><p>unignore(selector)【返回值:Validform】</p><p>将ignore方法所忽略验证的对象重新获取验证效果,不传入selector则恢复验证所有表单元素。</p><p>如demo.unignore(&quot;select,textarea,#name&quot;),恢复Validform对象下所有select,textarea及一个id为&quot;name&quot;元素的验证。</p><p>check(bool,selector)【返回值:Boolean】</p><p>bool为true时则只验证不显示提示信息</p><p>对指定对象进行验证(默认验证当前整个表单),通过返回true,否则返回false(绑定实时验证的对象,格式符合要求时返回true,而不会等ajax的返回结果)</p><p>如demo.check(),验证当前整个表单,且只验证但不显示对错信息。</p><p>config(setup) 5.3+ 【返回值:Validform】</p><p>setup参数是一个对象。</p><p>如:</p><p>demo.config({</p><p> showAllError:true,</p><p> url:&quot;这里指定提交地址&quot;,</p><p> ajaxpost:{</p><p> //可以传入$.ajax()能使用的,除dataType外的所有参数;</p><p> },</p><p> ajaxurl:{</p><p> //可以传入$.ajax()能使用的,除dataType外的所有参数;</p><p> }</p><p>})</p><p>可用参数:</p><p>tiptype等 5.3.2+:可以在这里设置初始化可用的所有参数</p><p>url:指定表单的提交路径,这里指定的路径会覆盖表单action属性所指定的路径</p><p>ajaxpost:表单以ajax提交时,可以在这里配置ajax的参数</p><p>ajaxurl:配置实时验证ajax的参数</p><p>①、config方法还能为已经初始化过的表单重新配置参数了!5.3.2+</p><p>如var demo=$(&quot;.formsub&quot;).Validform();</p><p>demo.config({tiptype:2});</p><p>demo下的各表单还能分别配置不同参数!</p><p>如demo.eq(0).config({tiptype:1,ajaxPost:true});</p><p>demo.eq(1).config({tiptype:1,callback:function(curform){my_method_to_submit_form(); return false;}});</p><p>②、执行config可以动态设置、添加参数,如:</p><p>demo.config({</p><p> url:&quot;http://validform.rjboy.cn&quot;</p><p>});</p><p>$(&quot;.save&quot;).click(function(){</p><p> demo.config({</p><p> ajaxpost:{</p><p> timeout:1000</p><p> }</p><p> });</p><p>});</p><p>那么在点击save按钮后,demo所对应的表单的config={</p><p> url:&quot;http://validform.rjboy.cn&quot;,</p><p> ajaxpost:{</p><p> timeout:1000</p><p> }</p><p>}</p><p>③、参数url的优先级:form表单的action所指定的提交地址会被config.url覆盖,</p><p>config.url会被config.ajaxpost.url覆盖,config.ajaxpost.url会被Validform对象的方法submitForm(flag,url)</p><p>和ajaxPost(flag,sync,url)里的url覆盖。</p><p>如果表单里没有指定action提交地址,那么就会提交到config.url设定的地址。</p><p>考虑到整个验证框架的逻辑,传入dataType参数不会起作用,不会被覆盖,ajax必须返回含有status值的json数据。</p><p>④、另外注意的是:传入的success和error方法里,能多获取到一个参数,如:</p><p>demo.config={</p><p> ajaxpost:{</p><p> <span class="Apple-tab-span" > </span>url:&quot;&quot;,</p><p> timeout:1000,</p><p> ...,</p><p> success:function(data,obj){</p><p> //data是返回的json数据;</p><p> //obj是当前表单的jquery对象;</p><p> },</p><p> error:function(data,obj){</p><p> //data是{ status:**, statusText:**, readyState:**, responseText:** };</p><p> //obj是当前表单的jquery对象;</p><p> }</p><p> },</p><p> ajaxurl:{</p><p> success:function(data,obj){</p><p> //data是返回的json数据;</p><p> //obj是当前正做实时验证表单元素的jquery对象;</p><p> //注意:5.3版中,实时验证的返回数据须是含有status值的json数据!</p><p> //跟callback里的ajax返回数据格式统一,建议不再返回字符串&quot;y&quot;或&quot;n&quot;。目前这两种格式的数据都兼容。</p><p> }</p><p> }</p><p>}</p><p>调用外部插件</p><p>文件上传 - swfupload</p><p>选择文件后立即上传</p><p>表单验证通过后上传文件</p><p>密码强度检测 - passwordStrength</p><p>密码强度提示与验证提示同时显示</p><p>在符合验证要求时才有密码强度提示</p><p>日期控件 - datePicker</p><p>默认效果</p><p>选择日期后执行回调函数</p><p>表单美化 - jqtransform</p><p>默认对所有元素美化</p><p>美化指定的表单元素</p><p>Validform的公用对象</p><p>$.Datatype</p><p>可以通过$.Datatype对象来扩展datatype类型。</p><p>如$.Datatype.zh=/^[\u4E00-\u9FA5\uf900-\ufa2d]{1,}$/</p><p>$.Tipmsg</p><p>可以通过$.Tipmsg对象来修改默认提示文字。具体可修改的提示文字请查看Validform对象的tipmsg属性。</p><p>如果Validform对象的tipmsg属性没有找到相关的提示信息,那么就会到$.Tipmsg中查找对应提示文字。</p><p>如$.Tipmsg.tit=&quot;msg box&quot;; //设置默认弹出框的标题文字。</p><p>$.Showmsg(msg)</p><p>调用Validform自定义的弹出框。</p><p>参数msg是要显示的提示文字。</p><p>如$.Showmsg(&quot;这是提示文字&quot;); //如果不传入信息则不会有弹出框出现,像$.Showmsg()这样是不会弹出提示框的。</p><p>$.Hidemsg()</p><p>关闭Validform自定义的弹出框。</p><p>如$.Hidemsg()</p>
T:0.006617s,M:280.02 KB
返回顶部 留言