EasyTools的AjaxTextBox

EasyTools的AjaxTextBox详解 前两天已经发布了AjaxTextBox控件，但上篇文章只是简单的说这个控件有什么特点，怎样用。今天说下这个控件的高级应用（适用于对js脚本有点了解的用户使用）。 先说下控件的一些属性吧！如下图： RegularExpression ---控件要验证的正则表达式，为空的时候表示不需要正则验证； ShowFiledId----------提示标签的id，加入为空，默认会把提示语句显示在控件后面。如果跟某个label关联的时候，提示语句就会在这个label上面显示。 注意：ShowFiledId不管值是否为空，要显示提示语句，都必须不要修改下面的1，2，3，4这4个属性， 1.ValidErrorFun-------验证失败时候触发的js函数,默认值是:Ets_AjaxTextBox_DefaultErrorfun。 2.AjaxExceptionFun---做ajax验证发生异常的时候触发的js函数，默认值是：Ets_AjaxTextBox_DefaultExceptionfun。 3.onloadFun-----------做ajax验证的过程中loadding服务端返回的验证结果的等待过程触发的函数，默认值是：Ets_AjaxTextBox_DefaultLoadfun 4.SuccessFun----------所有验证都通过时执行的js函数，默认值是：Ets_AjaxTextBox_DefaultSuccessfun 5.CustomFun----------如果用户觉得上面的几种验证还是不能满足要求的话，可以考虑使用这个属性。默认值是：空。 上面这5个属性后面再特别介绍，如果用户自定义函数该怎么写。 IsShowPic--------------是否显示默认图片，如下图的√，X等图标 ValidErrorColor----------验证错误时ShowFiledId绑定的提示区域的文字颜色；（该效果只有在使用默认函数配置时有效，只要跟ShowFiledId相关的都要满足这个条件，如上面的：IsShowPic） ValidSuccessColor-------验证成功时的文字颜色。（跟ShowFiledId相关） 还有一些文字提示的属性也是跟ShowFiledId相关。 EmptyErrorString------为空的时候提示的文字。（该属性只有在属性AllowEmpty=true的时候才有效） RegularErrorString-----正则匹配不通过的时候提示的文字。(该属性只有在RegularExpression!=""的时候才有效) LengthErrorString------长度验证不通过的时候提示的文字。 AjaxErrorString--------ajax验证不通过的时候提示的文字。（该属性只有当有服务端的ajax事件时才有效） AjaxExceptionString----ajax验证服务端发生异常的时候提示的文字。（该属性只有当有服务端的ajax事件时才有效） AjaxLoadString--------ajax请求等待过程中的提示文字。（该属性只有当有服务端的ajax事件时才有效） SuccessString----------验证成功的时候显示的文字。 另外一些其他的属性 OnEvent---------------一个枚举类型，可以选择控件发生验证是在哪个事件里面。有两个值给选：onchange和onblur AllowEmpty------------是否允许为空 MaxLen----------------输入框输入的最大长度，中文按两个字符算 IsValid------------------是否所有验证都通过，包括ajax验证，系统在后台会再次调用ajax事件. 这个控件是继承TextBox后开发，主要的事件只是添加多一个AjaxRequest事件。上面文章已经说过。 基本整个控件的东西都在这里了。下面说下用户自定义js函数该怎么写: 1.ValidErrorFun-------验证失败时候触发的js函数,默认值是:Ets_AjaxTextBox_DefaultErrorfun。 先看下Ets_AjaxTextBox_DefaultErrorfun Code 1function Ets_AjaxTextBox_DefaultErrorfun(obj,lbobj,wrongtag) 2{ 3 lbobj.style.color = obj.errcolor; 4 if(obj.isshowpic) 5 { 6 switch (wrongtag) 7 { 8 case 1: 9 lbobj.innerHTML=Ets_AjaxTextBox_Source.errpic+obj.empstr; 10 break; 11 12 case 2: 13 lbobj.innerHTML=Ets_AjaxTextBox_Source.errpic+obj.expstr; 14 break; 15 16 case 3: 17 lbobj.innerHTML=Ets_AjaxTextBox_Source.errpic+obj.lenstr; 18 break; 19 20 case 4: 21 lbobj.innerHTML=Ets_AjaxTextBox_Source.errpic+obj.aerrstr; 22 break; 23 24 case 5: 25 lbobj.innerHTML=Ets_AjaxTextBox_Source.errpic+obj.cusstr; 26 break; 27 } 28 } 29 else 30 { 31 switch (wrongtag) 32 { 33 case 1: 34 lbobj.innerHTML=obj.empstr; 35 break; 36 37 case 2: 38 lbobj.innerHTML=obj.expstr; 39 break; 40 41 case 3: 42 lbobj.innerHTML=obj.lenstr; 43 break; 44 45 case 4: 46 lbobj.innerHTML=obj.aerrstr; 47 break; 48 49 case 5: 50 lbobj.innerHTML=obj.cusstr; 51 break; 52 } 53 } 54}; Ets_AjaxTextBox_DefaultErrorfun(obj,lbobj,wrongtag) 这里跟大家说明这几个参数 1.obj指的验证控件对象，他有几个属性： isshowpic，是否显示图标 empstr，为空时显示的字符 expstr，正则匹配不通过的时候显示的文字 lenstr，长度太长显示的文字 aerrstr，ajax验证失败的时候显示的文字 aloastr，ajax验证过程中显示的文字 aexcstr，ajax异常的文字 cusstr，用户自定义验证不通过显示的文字 2.lbobj指的是绑定的label对象 3.wrongtag，通过这个参数，可以知道目前是什么过程发生验证错误，它有下面几个值： 值1：为空的验证失败；值2：正则验证失败；值3：长度验证失败；值4：ajax验证失败；值5：用户自定义函数验证失败； 整个验证顺序按1,2,3,5,4 的顺序验证 如果用想自己写这个验证错误时的js函数，可以参考上面Ets_AjaxTextBox_DefaultErrorfun(obj,lbobj,wrongtag)，参数不变。 2.AjaxExceptionFun---做ajax验证发生异常的时候触发的js函数，默认值是：Ets_AjaxTextBox_DefaultExceptionfun。 3.onloadFun-----------做ajax验证的过程中loadding服务端返回的验证结果的等待过程触发的函数，默认值是：Ets_AjaxTextBox_DefaultLoadfun 4.SuccessFun----------所有验证都通过时执行的js函数，默认值是：Ets_AjaxTextBox_DefaultSuccessfun 5.CustomFun----------如果用户觉得上面的几种验证还是不能满足要求的话，可以考虑使用这个属性。默认值是：空。 这几个客户端函数都是型如：XXXX(obj,lbobj) 传入参数跟上面的一样，只是少了个wrongtag，用户如果想自己写这几个函数，可以参照控件默认函数，自己写出自定义的验证函数，达到你想要的任何效果。 补充下CustomFun一定要有返回值，如果通过用户字定义的验证方法，return true;否则return false; 最后希望大家在使用过程中有什么好的意见或bug都可以联系我。邮箱:[e-mail] 谢谢！