jQuery formValidator表单验证插件开源了!!含API帮助、源码、示例

插件主页: http://www.yhuan.com/ 求助帖，每帖必应

   jQuery formValidator表单验证插件，它是基于jQuery类库，实现了js脚本于页面html代码的分离。你可以划分多个校验组，每个组的校验都是互不影响。对一个表单对象，你只需要写一行代码就可以轻松实现无数种（理论上）脚本控制。目前支持5种大的校验方式，分别是：inputValidator（针对input、textarea、select控件的字符长度、值范围、选择个数的控制）、compareValidator（提供2个对象的比较，目前可以比较字符串和数值型）、ajaxValidator（通过ajax到服务器上做数据校验）、regexValidator（提供可扩展的正则表达式库） 、functionValidator （可使用外部函数来做校验）

本插件于其他校验控件最大的区别有3点：

1、校验功能可以扩展。
        对中文、英文、数字、整数、实数、Email地址格式、基于HTTP协议的网址格式、电话号码格式、手机号码格式、货币格式、邮政编码、身份证号码、QQ号码、日期等等这些控制，别的表单校验控件是代码里写死的，而formValidator是通过外部js文件来扩展的，你可以通过写正则表达式和函数来无限的扩展这些功能。

2、实现了校验代码于html代码的完全分离。
        你的所有信息都无需配置在校验表单元素上，你只要在js上配置你的信息。使美工（界面）和javascript工程师的工作不交织在一起

3、你只需写一行代码就能完成一个表单元素的所有校验。你只需要写一行代码就能完成一下所有的控制

• 支持所有类型客户端控件的校验
• 支持jQuery所有的选择器语法，只要控件有唯一ID和type属性
• 支持函数和正则表达式的扩展。提供扩展库formValidatorReg.js，你可以自由的添加、修改里面的内容。
• 支持2种校验模式。第一种：文字提示(showword模式)；第二种：弹出窗口提示(showalert模式)
• 支持多个校验组。如果一个页面有多个提交按钮，分别做不同得提交，提交前要做不同的校验，所以你得用到校验组的功能。
• 支持4种状态的信息提示功能，可以灵活的控制4种状态是否显示。第一种：刚打开网页的时候进行提示；第二种：获得焦点的时候进行提示；第三种：失去焦点时，校验成功时候的提示；第四种：失去焦点时，校验失败的错误提示。
• 支持自动构建提示层。可以进行精确的定位。
• 支持自定义错误提示信息。
• 支持控件的字符长度、值范围、选择个数的控制。值范围支持数值型和字符型；选择的个数支持radio/checkbox/select三种控件
• 支持2个控件值的比较。目前可以比较字符串和数值型。
• 支持服务器端校验。
• 支持输入格式的校验。

 

2011/5/22 jQuery formValidator 4.0.1 ver

规范插件的命名：
1、对插件所有函数相关属性的命名采用Camel风格命名，即：第一个单词首字母小写，其余单词首字母大写。本次变动比较大，为了规范插件的命名，希望大家谅解。
2、所有DEMO引用jQuery类库的时候，类库后面直接跟了版本号——表示插件支持的最高类库版本号

 

为ajaxValidator函数增加以下功能： 
1、解决页面回退之后，控件获得焦点，不做任何修改，失去焦点后，强行验证 
2、formValidator的ajax参数(是否要提交到服务器)默认值改为false，但是ajaxValidator校验的控件无条件提交服务器 
3、在url后面增加随机数。name名字为rand 
4、提交之前有数据正在服务器端校验，不允许提交。如果在点击提交按钮之前，有触发ajaxValidator校验的，在提交的时候默认不允许，可以自定义错误提示，在initConfig函数里配置参数（submitAfterAjaxPrompt，默认值“当前有数据正在进行服务器端校验，请稍候”） 
5、如果在点击提交之前，如果一个控件一次都没有校验过，而且含有 ajaxValidator校验，会自动触发，而且异步返回成功之后，会再次触发提交

 

其他新增和修改：
1、修改initConfig里的error事件，errorlist参数的输出顺序，跟控件的校验顺序相同，如果正确，对应位置的值为null 
2、initConfig增加参数submitButtonID，表示触发验证的按钮ID，如果配置了formID，则formID 优先 
3、reloadAutoTip、resetTipState和pageIsValid函数的参数(validatorGroup)为空，则默认当做"1"处理
4、删除函数triggerValidate
5、intiConfig增加属性inIframe，表示页面是否嵌在iframe里，默认false
6、alertMessage模式下，默认自动修复错误，即autoModify=true
7、增加FAQ里的提问
8、修改用户手册
9、demo1里增加2选1的范例、把错误集中显示的范例；
10、demo2里触提交用submitButtonID属性

解决以下BUG： 
1、regexValidator第一次验证通过后，后面输入非法字符也验证通过的问题 
2、处理升级之后，demo1里的“全角字符当做1个长度”按钮出错的问题 
3、修复retSetTipState重置的时候，全部重置成onshow的问题，有些刚开始默认是通过的 
4、解决捆绑ajaxValidator校验的控件，在页面回退之后，控件获得焦点，不做任何修改，失去焦点后，验证错误的问题 
5、解决自动构建提示层示例全部团聚在左上角的问题,详见demo6.html内嵌在demo.html里的代码调用

 

 

更多的升级记录，请点击这里


1、现场演示

http://www.yhuan.com/formvalidator/demo1.htm

 

2、jQuery formValidator插件主要功能

 

1. 支持所有类型客户端控件的校验
2. 支持jQuery所有的选择器语法，只要控件有唯一ID和type属性
3. 支持函数和正则表达式的扩展。提供扩展库formValidatorReg.js，你可以自由的添加、修改里面的内容。
4. 支持2种校验模式。第一种：文字提示(showword模式)；第二种：弹出窗口提示(showalert模式)
5. 支持多个校验组。如果一个页面有多个提交按钮，分别做不同得提交，提交前要做不同的校验，所以你得用到校验组的功能。
6. 支持4种状态的信息提示功能，可以灵活的控制4种状态是否显示。第一种：刚打开网页的时候进行提示；第二种：获得焦点的时候进行提示；第三种：失去焦点时，校验成功时候的提示；第四种：失去焦点时，校验失败的错误提示。
7. 支持自动构建提示层。可以进行精确的定位。
8. 支持自定义错误提示信息。
9. 支持控件的字符长度、值范围、选择个数的控制。值范围支持数值型、字符型、日期型；选择的个数支持radio/checkbox/select三种控件
10. 支持2个控件值的比较。目前可以比较字符串和数值型、日期型。
11. 支持服务器端校验。
12. 支持输入格式的校验。
13. 支持换肤
    

 

3、jQuery formValidator插件 API帮助文档

帮助文档请点击这里 


4、下载API帮助、源码、示例

http://files.cnblogs.com/wzmaodong/formValidator4.0.1.zip


5、示例代码

<script type="text/javascript">
$(document).ready(function(){
 $.formValidator.initConfig({onError:function(){alert("校验没有通过，具体错误请看错误提示")}});
 $("#test1").formValidator({onshow:"请输入用户名",onfocus:"用户名至少6个字符,最多10个字符",oncorrect:"恭喜你,你输对了"}).InputValidator({min:6,max:10,onerror:"你输入的用户名非法,请确认"});

 $("#test2").formValidator({onshow:"请选择你的兴趣爱好(至少选择3个,最多选择5个)",onfocus:"你至少选择3个,最多选择5个",oncorrect:"恭喜你,你选对了"}).InputValidator({min:3,max:5,onerror:"你选的个数不对(至少选择3个,最多选择5个)"});

 $("#test3").formValidator({onshow:"请选择你的兴趣爱好（至少选一个）",onfocus:"你至少选择1个",oncorrect:"恭喜你,你选对了"}).InputValidator({min:1,onerror:"你选的个数不对"});

 $("#xueli").formValidator({onshow:"请选择你的学历",onfocus:"学历必须选择",oncorrect:"谢谢你的配合"}).SelectValidator({onerror: "你是不是忘记选择学历了!"});

 $("#password1").formValidator({onshow:"请输入密码",onfocus:"两次密码必须一致哦",oncorrect:"密码一致"}).InputValidator({min:1,onerror:"密码不能为空,请确认"}).CompareValidator({desID:"password2",operateor:"=",onerror:"2次密码不一致,请确认"});

 $("#nl").formValidator({onshow:"请输入的年龄（1-99岁之间）",onfocus:"只能输入1-99之间的数字哦",oncorrect:"恭喜你,你输对了"}).InputValidator({min:1,max:99,type:"value",onerror:"年龄必须在1-99之间，请确认"});

 $("#aiguo").formValidator({onshow:"爱国的人一定要选哦",onfocus:"你得认真思考哦",oncorrect:"不知道你爱不爱，反正你是选了"}).InputValidator({min:1,max:1,onerror:"难道你不爱国？你给我选！！！！"});

 $("#shouji").formValidator({empty:true,onshow:"请输入你的手机号码，可以为空哦",onfocus:"你要是输入了，必须输入正确",oncorrect:"谢谢你的合作",onempty:"你真的不想留手机号码啊？"}).InputValidator({min:11,max:11,onerror:"手机号码必须是11位的,请确认"}).RegexValidator({regexp:"^[1][0-9]{10}$",onerror:"你输入的手机格式不正确"});

 $("#lxdh").formValidator({empty:true,onshow:"请输入你的联系电话，可以为空哦",onfocus:"你要是输入了，必须输入正确，格式例如：0577-88069620",oncorrect:"谢谢你的合作",onempty:"你真的不想留联系电话了吗？"}).RegexValidator({regexp:"^[[0-9]{3}-|\[0-9]{4}-]?(\[0-9]{8}|[0-9]{7})?$",onerror:"你输入的联系电话格式不正确"});

 $("#ms").formValidator({onshow:"请输入你的描述",onfocus:"描述至少要输入10个汉字或20个字符",oncorrect:"恭喜你,你输对了"}).InputValidator({min:20,onerror:"你输入的描述长度不正确,请确认"});
});
</script>


6、特别说明

如果你在使用过程中碰到什么问题请给我留言，发现bug请不要自行修改，也请留言，达到完善插件的目的，真正服务每个程序开发人员 .
请保留插件的版权申明，谢谢