专注JavaWeb开发 首页制式『默认式 OR 时间轴 网站地图|RSS订阅|设为首页|加入收藏
当前位置:首页 >前端 >jQuery > 正文

validationEngine中文版

来源: 博客园 作者: 博客园 发布时间: 2015-04-02 浏览次数:

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

这个插件支持大部分的浏览器,但由于有使用到了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. <script src="js/jquery.js" type="text/javascript"></script> 

  3. <script src="js/jquery.validationEngine-en.js" type="text/javascript"></script> 

  4. <script src="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. successfalse,

  4. failure : function() { callFailFunction()  } 

  5. })

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

  1. $("#formID").validationEngine({ 

  2. validationEventTriggers:"keyup blur"//will validate on keyup and blur  

  3. successfalse,

  4. failure : function() { callFailFunction()  } 

  5. })

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

修改提示层的位置

  1. $("#formID").validationEngine({ 

  2. promptPosition: "topRight", // OPENNING BOX POSITION, IMPLEMENTED: topLeft, topRight, bottomLeft,  centerRight, bottomRight

  3. successfalse,

  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.  successfalse,

  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要修改的地方:

 

  1. calculatedPosition.callerTopPosition += "px";   

  2.            calculatedPosition.callerleftPosition += "px";   

  3.            calculatedPosition.marginTopSize += "px";   

  4.            //add matychen    

  5.            if ( $.browser.msie && /6.0/.test(navigator.userAgent) ) {   

  6.            $(divFormError).append('<iframe class="iframe" frameborder="0" scr="javascript:false;"></iframe>');   

  7.            }   

  8.            // add matychen   

  9.            $(divFormError).css({   

  10.                "top": calculatedPosition.callerTopPosition,   

  11.                "left": calculatedPosition.callerleftPosition,   

  12.                "marginTop": calculatedPosition.marginTopSize,   

  13.                "opacity": 0   

  14.            });  


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

  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如下:

  1. <!DOCTYPE HTML PUBLIC "-//IETF//DTD LEVEL1//EN">   

  2. <html>   

  3.   <head>   

  4.     <title>formvalidator.html</title>   

  5.        

  6.     <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">   

  7.     <meta http-equiv="description" content="this is my page">   

  8.     <meta http-equiv="content-type" content="text/html; charset=UTF-8">   

  9.         <link rel="stylesheet" href="formValidator/css/validationEngine.jquery.css" type="text/css" />   

  10.         <link rel="stylesheet" href="formValidator/css/template.css" type="text/css" />   

  11.         <script src="formValidator/jquery.js" type="text/javascript"></script>   

  12.         <script src="formValidator/js/jquery.validationEngine-cn.js" type="text/javascript"></script>   

  13.         <script src="formValidator/js/jquery.validationEngine.js" type="text/javascript"></script>   

  14.   

  15.   

  16. <script>     

  17.         $(document).ready(function() {   

  18.             $("#formID").validationEngine({   

  19.             validationEventTriggers:"blur",  //触发的事件  validationEventTriggers:"keyup blur",   

  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>   

  29.      

  30.   <body>   

  31.     <form id="formID" class="formular" method="post" action="">   

  32.             <fieldset>   

  33.                 <legend>User informations</legend>   

  34.                 <label>   

  35.                     <span>Desired username (ajax validation, only karnius is available) : </span>   

  36.                     <input value="" class="validate[required,custom[noSpecialCaracters],length[0,20],ajax[ajaxUser]]" type="text" name="user" id="user" />//ajax验证用户名的地方   

  37.                 </label>   

  38.                 <label>   

  39.                     <span>First name (optional)</span>   

  40.                     <input value="karnius"  class="validate[optional,custom[onlyLetter],length[0,100]] text-input" type="text" name="firstname" id="firstname" />   

  41.                 </label>   

  42.                 <label>   

  43.                     <span>Last name : </span>   

  44.                     <input value="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>Radio Groupe : <br /></span>   

  48.                     <span>radio 1: </span>   

  49.                     <input class="validate[required] radio" type="radio" name="data[User][preferedColor]"  id="radio1"  value="5">   

  50.                     <span>radio 2: </span>   

  51.                     <input class="validate[required] radio" type="radio" name="data[User][preferedColor]"  id="radio2"  value="3"/>   

  52.                     <span>radio 3: </span>   

  53.                     <input class="validate[required] radio" type="radio" name="data[User][preferedColor]"  id="radio3"  value="9"/>   

  54.                 </div>   

  55.                 <div>   

  56.                     <span>Minimum 2 checkbox : <br /></span>   

  57.                    

  58.                     <input class="validate[minCheckbox[2],maxCheckbox[3]] checkbox" type="checkbox"  name="data[User3][preferedColor]" id="data[User3][preferedColor]" value="5">   

  59.                     <input class="validate[minCheckbox[2],maxCheckbox[3]] checkbox" type="checkbox"  name="data[User3][preferedColor]" id="data[User3][preferedColor]" value="5">   

  60.                        

  61.                     <input class="validate[minCheckbox[2],maxCheckbox[3]] checkbox" type="checkbox" name="data[User3][preferedColor]" id="maxcheck2"  value="3"/>   

  62.                    

  63.                     <input class="validate[minCheckbox[2],maxCheckbox[3]] checkbox" type="checkbox" name="data[User3][preferedColor]" id="maxcheck3"  value="9"/>   

  64.                 </div>   

  65.                 <label>   

  66.                     <span>Date : (format YYYY-MM-DD)</span>   

  67.                     <input value="1111-11-11"  class="validate[required,custom[date]] text-input" type="text" name="date"  id="date" />   

  68.                 </label>   

  69.                 <label>   

  70.                     <span>Favorite sport 1:</span>   

  71.                 <select name="sport" id="sport"  class="validate[required]"  id="sport"  >   

  72.                     <option value="">Choose a sport</option>   

  73.                     <option value="option1">Tennis</option>   

  74.                     <option value="option2">Football</option>   

  75.                     <option value="option3">Golf</option>   

  76.                 </select>   

  77.                 </label>   

  78.                 <label>   

  79.                     <span>Favorite sport 2:</span>   

  80.                 <select name="sport2" id="sport2" multiple class="validate[required]"  id="sport2"  >   

  81.                     <option value="">Choose a sport</option>   

  82.                     <option value="option1">Tennis</option>   

  83.                     <option value="option2">Football</option>   

  84.                     <option value="option3">Golf</option>   

  85.                 </select>   

  86.                 </label>   

  87.                 <label>   

  88.                     <span>Age : </span>   

  89.                     <input value="22"  class="validate[required,custom[onlyNumber],length[0,3]] text-input" type="text" name="age"  id="age" />   

  90.                 </label>   

  91.                        

  92.                 <label>   

  93.                     <span>Telephone : </span>   

  94.                     <input value="1111111"  class="validate[required,custom[telephone]] text-input" type="text" name="telephone"  id="telephone" />   

  95.                 </label>   

  96.                 <label>   

  97.                     <span>mobilephone : </span>   

  98.                     <input value="111111"  class="validate[required,custom[mobilephone]] text-input" type="text" name="telphone"  id="telphone" />   

  99.                 </label>   

  100.                 <label>   

  101.                     <span>chinese : </span>   

  102.                     <input value="asdf"  class="validate[required,custom[chinese]] text-input" type="text" name="chinese"  id="chinese" />   

  103.                 </label>   

  104.                 <label>   

  105.                     <span>url : </span>   

  106.                     <input value="url"  class="validate[required,custom[url]] text-input" type="text" name="url"  id="url" />   

  107.                 </label>   

  108.                 <label>   

  109.                     <span>zipcode : </span>   

  110.                     <input value="zipcode"  class="validate[required,custom[zipcode]] text-input" type="text" name="zipcode"  id="zipcode" />   

  111.                 </label>   

  112.                 <label>   

  113.                     <span>ip : </span>   

  114.                     <input value="ip"  class="validate[required,custom[ip]] text-input" type="text" name="ip"  id="ip" />   

  115.                 </label>   

  116.                 <label>   

  117.                     <span>qq : </span>   

  118.                     <input value="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.                     <input value="karnius"  class="validate[required,length[6,11]] text-input" type="password" name="password"  id="password" />   

  126.                 </label>   

  127.                 <label>   

  128.                     <span>Confirm password : </span>   

  129.                     <input value="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>Email address : </span>   

  136.                     <input value="ced@hotmail.com"  class="validate[required,custom[email]] text-input" type="text" name="email" id="email"  />   

  137.                 </label>   

  138.                 <label>   

  139.                     <span>Confirm email address : </span>   

  140.                     <input value="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.                     <textarea value="ced@hotmail.com" class="validate[required,length[6,300]] text-input" name="comments" id="comments" /> </textarea>   

  148.                 </label>   

  149.   

  150.             </fieldset>   

  151.             <fieldset>   

  152.                 <legend>Conditions</legend>   

  153.                 <div class="infos">Checking this box indicates that you accept terms of use. If you do not accept these terms, do not use this website : </div>   

  154.                 <label>   

  155.                     <span class="checkbox">I accept terms of use : </span>   

  156.                     <input class="validate[required] checkbox" type="checkbox"  id="agree"  name="agree"/>   

  157.                 </label>   

  158.             </fieldset>   

  159. <input class="submit" type="submit" value="Validate & Send the form!"/>   

  160. <hr/>   

  161. </form>   

  162.   </body>   

  163. </html>  


jquery.validationEngine-cn.js如下:

  1.   

  2.   

  3. (function($) {   

  4.     $.fn.validationEngineLanguage = function() {};   

  5.     $.validationEngineLanguage = {   

  6.         newLang: function() {   

  7.             $.validationEngineLanguage.allRules =   {"required":{               // Add your regex rules here, you can take telephone as an example   

  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如下参数:validateError    ajaxUser;validateId user;validateValue  cccc   

  66.                         "alertTextOk":"* 帐号可以使用.",     

  67.                         "alertTextLoad":"* 检查中, 请稍后...",   

  68.                         "alertText":"* 帐号不能使用."},      

  69.                     "ajaxName":{   

  70.                         "file":"validateUser.php",   

  71.                         "alertText":"* This name is already taken",   

  72.                         "alertTextOk":"* This name is available",      

  73.                         "alertTextLoad":"* Loading, please wait"}                      

  74.                     }      

  75.         }   

  76.     }   

  77. })(jQuery);   

  78.   

  79. $(document).ready(function() {     

  80.     $.validationEngineLanguage.newLang()   

  81. });  

 

 

部分jquery.validationEngine.js

  1. /* AJAX VALIDATION HAS ITS OWN UPDATE AND BUILD UNLIKE OTHER RULES */      

  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(){     // BUILD A LOADING PROMPT IF LOAD TEXT EXIST                       

  9.                         if($.validationEngine.settings.allrules[customAjaxRule].alertTextLoad){   

  10.                            

  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文件:

  1.         <struts>   

  2.     <package name="json" extends="json-default">   

  3.         <!--验证-->   

  4.         <action name="validate" class="com.bw30.zjvote.action.ValidateAction"  

  5.             method="vali">   

  6.             <result type="json">   

  7.             <param name="excludeProperties">msg</param>//jsonplugin-0.32.jar   

  8.             </result>   

  9.         </action>   

  10.            

  11.     </package>   

  12. </struts>  


validateAction

  1. public String vali() {   

  2.         ActionContext ac = ActionContext.getContext();   

  3.         HttpServletRequest request = (HttpServletRequest) ac   

  4.         .get(ServletActionContext.HTTP_REQUEST);   

  5.         String validateId = request.getParameter("validateId");   

  6.         logger.info("vali() - String validateId=" + validateId);   

  7.   

  8.         String validateValue = request.getParameter("validateValue");   

  9.         String validateError = request.getParameter("validateError");   

  10.         logger.info("vali() - String validateError=" + 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.         return SUCCESS;   

  19.     }  

 

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

  1. success: function(data){                    // GET SUCCESS DATA RETURN JSON   

  2.                         data = eval( "("+data+")");             // GET JSON DATA FROM PHP AND PARSE IT   

  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;   

  9.                            

  10.                          if(ajaxisError == "false"){            // DATA FALSE UPDATE PROMPT WITH ERROR;   

  11.                                

  12.                             _checkInArray(false)                // Check if ajax validation alreay used on this field   

  13.                                

  14.                             if(!existInarray){                  // Add ajax error to stop submit                   

  15.                                 $.validationEngine.ajaxValidArray[ajaxErrorLength] =  new Array(2);   

  16.                                 $.validationEngine.ajaxValidArray[ajaxErrorLength][0] = fieldId;   

  17.                                 $.validationEngine.ajaxValidArray[ajaxErrorLength][1] = false;   

  18.                                 existInarray = false;   

  19.                             }  


用到了jsonplugin-0.32.jar这个包在附件里面,其他struts的包,自己添加。


QQ群: 武汉地区(142173356)验证消息JavaWeb1024

网友共有【】评论,点击查看



x 微信关注我们 随时获取最新网站资讯