基于jQuery的表单验证插件：jValidate

港控/mmm° 2022-02-02 07:55 327阅读 0赞

网上基于jQuery的表单验证插件已有很多，但是这个轮子我还是继续做一个，因为这个表单验证插件是从我以前的个人JS框架移值过来的（我已慢慢投入jQuery的怀抱），并且它的验证规则书写方式也许会让你眼前一亮。

网上的各类表单验证插件的验证规则都是写在脚本里的，但我的插件的验证规则却是写在表单元素的属性里的。如下面的例子：

< input name ="name" type ="text" id ="name" size ="30" jvpattern ="^.+$" jverrortip ="请输入正确的姓名." jvtipid ="spt\_name" jvmethod ="checkname" />

注意看上面代码中以“jv“开头的各种属性名，这些都是表单验证插件需要用的属性值。其中各属性代表的意思请阅读以下表：

**1、form表格控件元素可使用的属性**：

<table style="border:1px solid #C0C0C0;border-collapse:collapse;color:rgb(51,51,51);font-family:verdana, Arial, Helvetica, sans-serif;font-size:14px;line-height:25.2px;"> 
 <tbody> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">属性名</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">说明</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jvpattern</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">用来验证控件值是否正确的正则表达式。（可不定义此属性)</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jvcompareid</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">需要与当前控件进行值相等比较的其它控件id。（可不定义此属性)</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jvrequired</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">表明当前控件值是否是必须的，也即是否允许当前控件值为空。如不定义此属性则默认为不可空，如果值为false或0则允许为空。（可不定义此属性)</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jvmethod</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;"> 定义需要进行额外验证的方法。（可不定义此属性) 此属性值如果定义，则不需要输写“括号”，并且函数原型为： xx&nbsp;function(item){ &nbsp;&nbsp;&nbsp; //代码 &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; //true表示验证成功，false表示验证失败。 &nbsp;&nbsp;&nbsp; return true/false; &nbsp;&nbsp;&nbsp; //或者带错误消息的返回 &nbsp;&nbsp;&nbsp; return {result:true/false, message:'错误消息'}; } 其中item参数是当前控件对象的jQuery实例。 </td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jvtipid</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;"> 显示验证提示信息的控件id。（可不定义此属性) 注：如果不定义此属性，并且未定义onerror或oncorrect函数则默认为alert提示 </td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jverrortip</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">当验证失败时要显示的提示信息。（可不定义此属性)</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jvcorrecttip</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">当验证成功时要显示的提示信息。（可不定义此属性)</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">jvfocuson</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">当验证失败后是否需要将光标移到控件上。（可不定义此属性)</td> 
 </tr> 
 </tbody> 
</table>

控件上必须定义：jvpattern、jvmethod、jvcompareid 三者之中的一个或多个，否则插件将不对对应的控件进行验证。

**2、tip提示控件元素可使用的属性**：tip提示控件即是某个表单控件jvtipid指定的控件。

当控件规则设置好后就可以直接激活调用jValidate，以便当表单进行submit提交前，进行验证检查。

示例：

$('form').jValidate();

或者带参数的调用：

![复制代码][copycode.gif]

$('form').jValidate(\{  
blurvalidate : true,  
isbubble : false,  
onerror : function(item,form)\{  
$.jMessageBox.show('错误', item.attr('jverrortip'));  
\}  
\});

![复制代码][copycode.gif]

可设置的参数请阅读下表：

<table style="border:1px solid #C0C0C0;border-collapse:collapse;color:rgb(51,51,51);font-family:verdana, Arial, Helvetica, sans-serif;font-size:14px;line-height:25.2px;"> 
 <tbody> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">参数名</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">说明</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">isbubble</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;"> 是否允许“冒泡”，也即是否允许逐个检查各控件值，如果值为true，则会逐一检查验证所有已设置验证规则的控件；如果值为false则当有一个控件值验证失败（不符合条件）后，将退出后续控件的检查。默认值为false 注：如果提示信息是以弹出窗口方式显示的，建议将此值设置为false，以免一下子弹出较多提示，引起用户反感。 </td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">blurvalidate</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">设置当个个控件失去焦点后是否需要即时检查验证。默认值为false。</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">emptytip</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;width:581px;">是否允许空提示。也即是当没有提示信息可显示时，是否还允许提示控件改变css类。默认值为false</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">validation</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;width:581px;">是否进行验证返回。 如果值为true则将进行直接验证，并返回验证结果，而非对象，默认值为false</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">validationOnSubmit</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;width:581px;">是否需要在form表单提交时(submit事件发生时）进行验证，默认值为true</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">focusOnError</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;width:581px;">在某个表单控件验证有错误时是否需要聚焦，默认值为true</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">focusOnBlurError</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;width:581px;">在某个表单控件在失去焦点时验证有错误时是否需要聚焦，默认值为false</td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">oncorrect</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;width:581px;"> 当控件值验证成功时调用处理的方法，如果未定义则采用默认行为。函数原型： function(item, form){ &nbsp;&nbsp; //代码 } 其中参数item: 表示当前控件的jQuery实例; form : 表示控件所在的表单实例 </td> 
 </tr> 
 <tr> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;">onerror</td> 
 <td style="border:1px solid #C0C0C0;border-collapse:collapse;width:581px;"> 当控件值验证失败时调用处理的方法，如果未定义则采用默认行为。函数原型： function(item, form){ &nbsp;&nbsp; //代码 } 其中参数item: 表示当前控件的jQuery实例; form : 表示控件所在的表单实例 </td> 
 </tr> 
 </tbody> 
</table>

示例截图：

![jvalidator.png][]

源码下载：(压缩包附带jMessageBox示例，关于jMessageBox请[参考此文][Link 1])

[/Files/kingthy/jvalidate.zip][Files_kingthy_jvalidate.zip]

当前版本：v1.0.2

本文转自Kingthy博客园博客，原文链接：http://www.cnblogs.com/kingthy/archive/2009/12/11/jValidate.html，如需转载请自行联系原作者

[copycode.gif]: /images/20220202/6862d91784a2404890e3ac1561f5f6c7.png
[jvalidator.png]: /images/20220202/775e2d16ad8f4166848020d965920713.png
[Link 1]: http://www.cnblogs.com/kingthy/archive/2009/12/09/jmessagebox.html
[Files_kingthy_jvalidate.zip]: http://files.cnblogs.com/kingthy/jvalidate.zip