`
zxingchao2005
  • 浏览: 75974 次
  • 性别: Icon_minigender_1
  • 来自: 北京
文章分类
社区版块
存档分类
最新评论

validationEngine中文版 — jquery强大的表单验证插件

阅读更多
中文汉化版，官方只有英文的。同时根据中国国情修改了部分验证规则。

这个插件支持大部分的浏览器，但由于有使用到了css3的阴影和圆角样式，所以在IE浏览器下无法看到圆角和阴影效果（万恶的IE）。

官方下载地址：http://www.position-absolute.com/articles/jquery-form-validator-because-form-validation-is-a-mess/

普通验证的例子：http://www.position-relative.net/creation/formValidator/

ajax验证的例子：http://www.position-relative.net/creation/formValidator/demoSubmit.html

一：简单说明下使用教程：

引入jquery和插件js、css

  1. <link rel="stylesheet" href="css/validationEngine.jquery.css" type="text/css" media="screen" charset="utf-8" />
  2. <scriptsrc="js/jquery.js" type="text/javascript"></script>
  3. <scriptsrc="js/jquery.validationEngine-en.js" type="text/javascript"></script>
  4. <scriptsrc="js/jquery.validationEngine.js" type="text/javascript"></script>

jquery.validationEngine-en.js是语言文件，所有的提示都在这个文件找的到，可以很方便的转成其他语言，同时你也可以在这个文件内定制属于自己的验证规则。

初始化插件

  1. $(document).ready(function() {
  2. $("#formID").validationEngine()
  3. })

验证规则是写在表单元素的class属性内。比如下面：

  1. <input value="" class="validate[required,custom[noSpecialCaracters],length[0,20],ajax[ajaxUser]]" type="text" name="user" id="user" />

验证规则非常多样，基本上包含了所有的数据类型的验证。
所有的验证规则写在validate[]内，有多种验证，用逗号隔开，这里简要说明下常用的验证规则。

  1. required：值不可以为空
  2. length[0,100] ：文字允许长度
  3. confirm[fieldID] ：匹配其他的表单元素的值，fieldID就是其他表单元素的id，这个主要用于再次确认密码
  4. telephone ：数据格式要求符合电话格式
  5. email ： 数据格式要求符合email 格式
  6. onlyNumber ：只允许输入数字
  7. noSpecialCaracters ：不允许出现特殊字符
  8. onlyLetter ： 只能是字母
  9. date ：必须符合日期格式YYYY-MM-DD

你还可以在点击提交按钮后才触发验证。

  1. $("#formID").validationEngine({
  2. inlineValidation: false,
  3. success : false,
  4. failure : function(){ callFailFunction() }
  5. })

默认的是在鼠标失去焦点后才开始验证，也就是绑定的是blur事件，那如何改变呢？看下面的配置。

  1. $("#formID").validationEngine({
  2. validationEventTriggers:"keyup blur", //will validate on keyup and blur
  3. success : false,
  4. failure : function(){ callFailFunction() }
  5. })

validationEventTriggers属性就是修改绑定事件，上面是增加了个keyup，也就是键盘按键起来就触发验证。

修改提示层的位置

  1. $("#formID").validationEngine({
  2. promptPosition: "topRight", // OPENNING BOX POSITION, IMPLEMENTED: topLeft, topRight, bottomLeft, centerRight, bottomRight
  3. success : false,
  4. failure : function(){
  5. })

promptPosition就是控制位置，有5种模式：topLeft, topRight, bottomLeft, centerRight, bottomRight

ajax验证模式

  1. $("#formID").validationEngine({
  2. ajaxSubmit: true,
  3. ajaxSubmitFile: "ajaxSubmit.php",
  4. ajaxSubmitMessage: "Thank you, we received your inscription!",
  5. ajaxSubmitExtraData: "securityCode=38709238423&name=john",
  6. success : false,
  7. failure : function() {}
  8. })

这几个参数很好理解。

  1. ajaxSubmit: true, 提交表单使用ajax提交
  2. ajaxSubmitFile: “ajaxSubmit.php”, 后台脚本
  3. ajaxSubmitMessage 成功后显示的信息
  4. ajaxSubmitExtraData 参数

这里需要对后台脚本返回的数据进行下说明：
返回的数据格式是json。
出现一个错误，产生一个数组，如下：

  1. $arrayError[0][0] = "#email"; // FIELDID
  2. $arrayError[0][1] = "Your email do not match.. whatever it need to match"; // TEXT ERROR
  3. $arrayError[0][2] = "error"; // BOX COLOR

二：修改过的地方

解决ie6下select遮挡div的办法
jquery.validationEngine.js要修改的地方：

Xml代码
  1. calculatedPosition.callerTopPosition+="px";
  2. calculatedPosition.callerleftPosition+="px";
  3. calculatedPosition.marginTopSize+="px";
  4. //addmatychen
  5. if($.browser.msie&&/6.0/.test(navigator.userAgent)){
  6. $(divFormError).append('<iframeclass="iframe"frameborder="0"scr="javascript:false;"></iframe>');
  7. }
  8. //addmatychen
  9. $(divFormError).css({
  10. "top":calculatedPosition.callerTopPosition,
  11. "left":calculatedPosition.callerleftPosition,
  12. "marginTop":calculatedPosition.marginTopSize,
  13. "opacity":0
  14. });


validationEngine.jquery.css里面加入以下代码：

Java代码
  1. .iframe{
  2. position:absolute;
  3. width:expression(this.parentNode.offsetWidth+\'px\');
  4. height:expression(this.parentNode.offsetHeight-32+\'px\');
  5. z-index:-1;
  6. top:expression(((parseInt(this.parentNode.currentStyle.borderTopWidth)||0)*-1)+\'px\');
  7. left:expression(((parseInt(this.parentNode.currentStyle.borderLeftWidth)||0)*-1)+\'px\');
  8. }

formvalidator.html如下：

Java代码
  1. <!DOCTYPEHTMLPUBLIC"-//IETF//DTDLEVEL1//EN">
  2. <html>
  3. <head>
  4. <title>formvalidator.html</title>
  6. <metahttp-equiv="keywords"content="keyword1,keyword2,keyword3">
  7. <metahttp-equiv="description"content="thisismypage">
  8. <metahttp-equiv="content-type"content="text/html;charset=UTF-8">
  9. <linkrel="stylesheet"href="formValidator/css/validationEngine.jquery.css"type="text/css"/>
  10. <linkrel="stylesheet"href="formValidator/css/template.css"type="text/css"/>
  11. <scriptsrc="formValidator/jquery.js"type="text/javascript"></script>
  12. <scriptsrc="formValidator/js/jquery.validationEngine-cn.js"type="text/javascript"></script>
  13. <scriptsrc="formValidator/js/jquery.validationEngine.js"type="text/javascript"></script>
  16. <script>
  17. $(document).ready(function(){
  18. $("#formID").validationEngine({
  19. validationEventTriggers:"blur",//触发的事件validationEventTriggers:"keyupblur",
  20. inlineValidation:true,//是否即时验证，false为提交表单时验证,默认true
  21. success:false,//为true时即使有不符合的也提交表单,false表示只有全部通过验证了才能提交表单,默认false
  22. promptPosition:"topRight",//提示所在的位置，topLeft,topRight,bottomLeft,centerRight,bottomRight
  23. //failure:function(){alert("验证失败，请检查。");}//验证失败时调用的函数
  24. //success:function(){callSuccessFunction()},//验证通过时调用的函数
  25. });
  26. });
  27. </script>
  28. </head>
  30. <body>
  31. <formid="formID"class="formular"method="post"action="">
  32. <fieldset>
  33. <legend>Userinformations</legend>
  34. <label>
  35. <span>Desiredusername(ajaxvalidation,onlykarniusisavailable):</span>
  36. <inputvalue=""class="validate[required,custom[noSpecialCaracters],length[0,20],ajax[ajaxUser]]"type="text"name="user"id="user"/>//ajax验证用户名的地方
  37. </label>
  38. <label>
  39. <span>Firstname(optional)</span>
  40. <inputvalue="karnius"class="validate[optional,custom[onlyLetter],length[0,100]]text-input"type="text"name="firstname"id="firstname"/>
  41. </label>
  42. <label>
  43. <span>Lastname:</span>
  44. <inputvalue="karnius"class="validate[required,custom[onlyLetter],length[0,100]]text-input"type="text"id="data[Use6][preferedColor]"name="lastname"/>
  45. </label>
  46. <div>
  47. <span>RadioGroupe:<br/></span>
  48. <span>radio1:</span>
  49. <inputclass="validate[required]radio"type="radio"name="data[User][preferedColor]"id="radio1"value="5">
  50. <span>radio2:</span>
  51. <inputclass="validate[required]radio"type="radio"name="data[User][preferedColor]"id="radio2"value="3"/>
  52. <span>radio3:</span>
  53. <inputclass="validate[required]radio"type="radio"name="data[User][preferedColor]"id="radio3"value="9"/>
  54. </div>
  55. <div>
  56. <span>Minimum2checkbox:<br/></span>
  58. <inputclass="validate[minCheckbox[2],maxCheckbox[3]]checkbox"type="checkbox"name="data[User3][preferedColor]"id="data[User3][preferedColor]"value="5">
  59. <inputclass="validate[minCheckbox[2],maxCheckbox[3]]checkbox"type="checkbox"name="data[User3][preferedColor]"id="data[User3][preferedColor]"value="5">
  61. <inputclass="validate[minCheckbox[2],maxCheckbox[3]]checkbox"type="checkbox"name="data[User3][preferedColor]"id="maxcheck2"value="3"/>
  63. <inputclass="validate[minCheckbox[2],maxCheckbox[3]]checkbox"type="checkbox"name="data[User3][preferedColor]"id="maxcheck3"value="9"/>
  64. </div>
  65. <label>
  66. <span>Date:(formatYYYY-MM-DD)</span>
  67. <inputvalue="1111-11-11"class="validate[required,custom[date]]text-input"type="text"name="date"id="date"/>
  68. </label>
  69. <label>
  70. <span>Favoritesport1:</span>
  71. <selectname="sport"id="sport"class="validate[required]"id="sport">
  72. <optionvalue="">Chooseasport</option>
  73. <optionvalue="option1">Tennis</option>
  74. <optionvalue="option2">Football</option>
  75. <optionvalue="option3">Golf</option>
  76. </select>
  77. </label>
  78. <label>
  79. <span>Favoritesport2:</span>
  80. <selectname="sport2"id="sport2"multipleclass="validate[required]"id="sport2">
  81. <optionvalue="">Chooseasport</option>
  82. <optionvalue="option1">Tennis</option>
  83. <optionvalue="option2">Football</option>
  84. <optionvalue="option3">Golf</option>
  85. </select>
  86. </label>
  87. <label>
  88. <span>Age:</span>
  89. <inputvalue="22"class="validate[required,custom[onlyNumber],length[0,3]]text-input"type="text"name="age"id="age"/>
  90. </label>
  92. <label>
  93. <span>Telephone:</span>
  94. <inputvalue="1111111"class="validate[required,custom[telephone]]text-input"type="text"name="telephone"id="telephone"/>
  95. </label>
  96. <label>
  97. <span>mobilephone:</span>
  98. <inputvalue="111111"class="validate[required,custom[mobilephone]]text-input"type="text"name="telphone"id="telphone"/>
  99. </label>
  100. <label>
  101. <span>chinese:</span>
  102. <inputvalue="asdf"class="validate[required,custom[chinese]]text-input"type="text"name="chinese"id="chinese"/>
  103. </label>
  104. <label>
  105. <span>url:</span>
  106. <inputvalue="url"class="validate[required,custom[url]]text-input"type="text"name="url"id="url"/>
  107. </label>
  108. <label>
  109. <span>zipcode:</span>
  110. <inputvalue="zipcode"class="validate[required,custom[zipcode]]text-input"type="text"name="zipcode"id="zipcode"/>
  111. </label>
  112. <label>
  113. <span>ip:</span>
  114. <inputvalue="ip"class="validate[required,custom[ip]]text-input"type="text"name="ip"id="ip"/>
  115. </label>
  116. <label>
  117. <span>qq:</span>
  118. <inputvalue="01234"class="validate[required,custom[qq]]text-input"type="text"name="qq"id="qq"/>
  119. </label>
  120. </fieldset>
  121. <fieldset>
  122. <legend>Password</legend>
  123. <label>
  124. <span>Password:</span>
  125. <inputvalue="karnius"class="validate[required,length[6,11]]text-input"type="password"name="password"id="password"/>
  126. </label>
  127. <label>
  128. <span>Confirmpassword:</span>
  129. <inputvalue="karnius"class="validate[required,confirm[password]]text-input"type="password"name="password2"id="password2"/>
  130. </label>
  131. </fieldset>
  132. <fieldset>
  133. <legend>Email</legend>
  134. <label>
  135. <span>Emailaddress:</span>
  136. <inputvalue="ced@hotmail.com"class="validate[required,custom[email]]text-input"type="text"name="email"id="email"/>
  137. </label>
  138. <label>
  139. <span>Confirmemailaddress:</span>
  140. <inputvalue="ced@hotmail.com"class="validate[required,confirm[email]]text-input"type="text"name="email2"id="email2"/>
  141. </label>
  142. </fieldset>
  143. <fieldset>
  144. <legend>Comments</legend>
  145. <label>
  146. <span>Comments:</span>
  147. <textareavalue="ced@hotmail.com"class="validate[required,length[6,300]]text-input"name="comments"id="comments"/></textarea>
  148. </label>
  150. </fieldset>
  151. <fieldset>
  152. <legend>Conditions</legend>
  153. <divclass="infos">Checkingthisboxindicatesthatyouaccepttermsofuse.Ifyoudonotaccepttheseterms,donotusethiswebsite:</div>
  154. <label>
  155. <spanclass="checkbox">Iaccepttermsofuse:</span>
  156. <inputclass="validate[required]checkbox"type="checkbox"id="agree"name="agree"/>
  157. </label>
  158. </fieldset>
  159. <inputclass="submit"type="submit"value="Validate&Sendtheform!"/>
  160. <hr/>
  161. </form>
  162. </body>
  163. </html>
jquery.validationEngine-cn.js如下：
Java代码
  3. (function($){
  4. $.fn.validationEngineLanguage=function(){};
  5. $.validationEngineLanguage={
  6. newLang:function(){
  7. $.validationEngineLanguage.allRules={"required":{//Addyourregexruleshere,youcantaketelephoneasanexample
  8. "regex":"none",
  9. "alertText":"*非空选项.",
  10. "alertTextCheckboxMultiple":"*请选择一个单选框.",
  11. "alertTextCheckboxe":"*请选择一个复选框."},
  12. "length":{
  13. "regex":"none",
  14. "alertText":"*长度必须在",
  15. "alertText2":"至",
  16. "alertText3":"之间."},
  17. "maxCheckbox":{
  18. "regex":"none",
  19. "alertText":"*最多选择",//官方文档这里有问题
  20. "alertText2":"项."},
  21. "minCheckbox":{
  22. "regex":"none",
  23. "alertText":"*至少选择",
  24. "alertText2":"项."},
  25. "confirm":{
  26. "regex":"none",
  27. "alertText":"*两次输入不一致,请重新输入."},
  28. "telephone":{
  29. "regex":"/^(0[0-9]{2,3}\-)?([2-9][0-9]{6,7})+(\-[0-9]{1,4})?$/",
  30. "alertText":"*请输入有效的电话号码,如:010-29292929."},
  31. "mobilephone":{
  32. "regex":"/(^0?[1][358][0-9]{9}$)/",
  33. "alertText":"*请输入有效的手机号码."},
  34. "email":{
  35. "regex":"/^[a-zA-Z0-9_\.\-]+\@([a-zA-Z0-9\-]+\.)+[a-zA-Z0-9]{2,4}$/",
  36. "alertText":"*请输入有效的邮件地址."},
  37. "date":{
  38. "regex":"/^(([0-9]{3}[1-9]|[0-9]{2}[1-9][0-9]{1}|[0-9]{1}[1-9][0-9]{2}|[1-9][0-9]{3})-(((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01]))|((0[469]|11)-(0[1-9]|[12][0-9]|30))|(02-(0[1-9]|[1][0-9]|2[0-8]))))|((([0-9]{2})(0[48]|[2468][048]|[13579][26])|((0[48]|[2468][048]|[3579][26])00))-02-29)$/",
  39. "alertText":"*请输入有效的日期,如:2008-08-08."},
  40. "ip":{
  41. "regex":"/^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/",
  42. "alertText":"*请输入有效的IP."},
  43. "chinese":{
  44. "regex":"/^[\u4e00-\u9fa5]+$/",
  45. "alertText":"*请输入中文."},
  46. "url":{
  47. "regex":"/^[a-zA-z]:\\/\\/[^s]$/",//这些验证请自己加强
  48. "alertText":"*请输入有效的网址."},
  49. "zipcode":{
  50. "regex":"/^[1-9]\d{5}$/",
  51. "alertText":"*请输入有效的邮政编码."},
  52. "qq":{
  53. "regex":"/^[1-9]\d{4,9}$/",
  54. "alertText":"*请输入有效的QQ号码."},
  55. "onlyNumber":{
  56. "regex":"/^[0-9]+$/",
  57. "alertText":"*请输入数字."},
  58. "onlyLetter":{
  59. "regex":"/^[a-zA-Z]+$/",
  60. "alertText":"*请输入英文字母."},
  61. "noSpecialCaracters":{
  62. "regex":"/^[0-9a-zA-Z]+$/",
  63. "alertText":"*请输入英文字母和数字."},
  64. "ajaxUser":{
  65. "file":"validate.action",//ajax验证用户名，会post如下参数：validateErrorajaxUser；validateIduser；validateValuecccc
  66. "alertTextOk":"*帐号可以使用.",
  67. "alertTextLoad":"*检查中,请稍后...",
  68. "alertText":"*帐号不能使用."},
  69. "ajaxName":{
  70. "file":"validateUser.php",
  71. "alertText":"*Thisnameisalreadytaken",
  72. "alertTextOk":"*Thisnameisavailable",
  73. "alertTextLoad":"*Loading,pleasewait"}
  74. }
  75. }
  76. }
  77. })(jQuery);
  79. $(document).ready(function(){
  80. $.validationEngineLanguage.newLang()
  81. });

部分jquery.validationEngine.js
Java代码
  1. /*AJAXVALIDATIONHASITSOWNUPDATEANDBUILDUNLIKEOTHERRULES*/
  2. if(!ajaxisError){
  3. $.ajax({
  4. type:"POST",
  5. url:postfile,
  6. async:true,
  7. data:"validateValue="+fieldValue+"&validateId="+fieldId+"&validateError="+customAjaxRule,//+extraData,//自己把其中的+extraData去掉了，不然后面的ajax验证有问题。
  8. beforeSend:function(){//BUILDALOADINGPROMPTIFLOADTEXTEXIST
  9. if($.validationEngine.settings.allrules[customAjaxRule].alertTextLoad){
  11. if(!$("div."+fieldId+"formError")[0]){
  12. return$.validationEngine.buildPrompt(ajaxCaller,$.validationEngine.settings.allrules[customAjaxRule].alertTextLoad,"load");
  13. }else{
  14. $.validationEngine.updatePromptText(ajaxCaller,$.validationEngine.settings.allrules[customAjaxRule].alertTextLoad,"load");
  15. }
  16. }
  17. },

struts.xml文件：

Java代码
  1. <struts>
  2. <packagename="json"extends="json-default">
  3. <!--验证-->
  4. <actionname="validate"class="com.bw30.zjvote.action.ValidateAction"
  5. method="vali">
  6. <resulttype="json">
  7. <paramname="excludeProperties">msg</param>//jsonplugin-0.32.jar
  8. </result>
  9. </action>
  11. </package>
  12. </struts>


validateAction

Java代码
  1. publicStringvali(){
  2. ActionContextac=ActionContext.getContext();
  3. HttpServletRequestrequest=(HttpServletRequest)ac
  4. .get(ServletActionContext.HTTP_REQUEST);
  5. StringvalidateId=request.getParameter("validateId");
  6. logger.info("vali()-StringvalidateId="+validateId);
  8. StringvalidateValue=request.getParameter("validateValue");
  9. StringvalidateError=request.getParameter("validateError");
  10. logger.info("vali()-StringvalidateError="+validateError);
  11. //注意下面的顺序，感觉这是个缺陷之一，不过可以在jquery.validationEngine.js更改，
  12. jsonValidateReturn.add(validateId);
  13. jsonValidateReturn.add(validateError);
  14. if(validateValue.equals("chen"))
  15. jsonValidateReturn.add("true");
  16. else
  17. jsonValidateReturn.add("false");
  18. returnSUCCESS;
  19. }

jquery.validationEngine.js要更改的地方：

Java代码
  1. success:function(data){//GETSUCCESSDATARETURNJSON
  2. data=eval("("+data+")");//GETJSONDATAFROMPHPANDPARSEIT
  3. ajaxisError=data.jsonValidateReturn[2];//这里官方文档写死了，可以根据自己需求更改。
  4. customAjaxRule=data.jsonValidateReturn[1];//这里官方文档写死了，可以根据自己需求更改。
  5. ajaxCaller=$("#"+data.jsonValidateReturn[0])[0];
  6. fieldId=ajaxCaller;
  7. ajaxErrorLength=$.validationEngine.ajaxValidArray.length;
  8. existInarray=false;
  10. if(ajaxisError=="false"){//DATAFALSEUPDATEPROMPTWITHERROR;
  12. _checkInArray(false)//Checkifajaxvalidationalreayusedonthisfield
  14. if(!existInarray){//Addajaxerrortostopsubmit
  15. $.validationEngine.ajaxValidArray[ajaxErrorLength]=newArray(2);
  16. $.validationEngine.ajaxValidArray[ajaxErrorLength][0]=fieldId;
  17. $.validationEngine.ajaxValidArray[ajaxErrorLength][1]=false;
  18. existInarray=false;
  19. }
用到了jsonplugin-0.32.jar这个包在附件里面，其他struts的包，自己添加。




分享到：
| ztree+dwr实现异步加载树形菜单
评论
1 楼 dancerjava 2012-08-11  
ie里面怎么没效果啊？firefox一切ok！求指点
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics