随笔- 25  评论- 2367  文章- 1 

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

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

升级记录

QQ交流群:74106519

 

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请不要自行修改,也请留言,达到完善插件的目的,真正服务每个程序开发人员 .
请保留插件的版权申明,谢谢

posted on 2008-01-11 11:12 猫冬 阅读(...) 评论(...) 编辑 收藏