目前支持4种大的校验方式，分别是：Input（针对input、 textarea、select控件）、CompareValidator、AjaxValidator、RegexValidator、 FunctionValidator每种格式支持的控件类型如下：
|
|
input |
textarea |
select |
| 校验方式 |
text |
radio |
checkbox |
file |
password |
textarea |
select-one |
| InputValidator |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
| CompareValidator |
√ |
|
|
√ |
√ |
√ |
|
| AjaxValidator |
√ |
|
|
√ |
√ |
√ |
√ |
| RegexValidator |
√ |
|
|
√ |
√ |
√ |
|
| FunctionValidator |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
如果你用了不支持的校验功能，插件将忽略这个校验功能。 |
| 插件目前提示错误，有两种模式：showword和 showalert,即文字提示和窗口提示，下面的5大验证方式，针对showalert这种方式不是都必须的，有些配置是没有作用的下面分别罗列全局初始化和5种校验方式公开的属性 |
| formValidator: |
用来做初始化的类型，必须先执行 |
| 属性 |
属性名称 |
默认值 |
showword |
showalert |
详细解释 |
| validatorGroup |
校验组 |
“1” |
√ |
√ |
一个页面的控件可以分成多个组，分开校验 |
| empty |
是否可以为空 |
false |
√ |
√ |
|
| automodify |
输入错误离开焦点的时候，自动修复错误 |
false |
√ |
√ |
先给出提示然后，自动修复，目前只支持text、file、textarea三种类型 |
| onempty |
空时候的提示 |
“输入内容为空” |
√ |
|
可以为空，为空时候的提示 |
| onshow |
显示时候的提示 |
“请输入内容” |
√ |
|
|
| onfocus |
获得焦点的提示 |
“请输入内容” |
√ |
|
|
| oncorrect |
输入正确后的提示 |
“输入正确” |
√ |
|
当你焦点离开控件的时候，如果输入正确将出现该提示 |
| onvalid |
校验通过后的回调函数 |
null |
√ |
√ |
参数1：对象本身 参数2：值 校验通过后，你还希望执行一些操作，你可以通过这个属性来执行。 |
| onfocusevent |
获得焦点后要追加的回调函数 |
null |
√ |
√ |
参数1：对象本身 |
| onblurevent |
失去焦点后要追加的回调函数 |
null |
√ |
√ |
参数1：对象本身 |
| tipid |
显示错误的容器ID |
表单ID+”Tip” |
√ |
|
|
| defaultvalue |
默认值 |
null |
√ |
√ |
所有input和select表单。如果你不设置就保持原值，一旦设置就设为默认值。 |
|
| |
|
|
|
| InputValidator： |
|
| 属性 |
属性名称 |
默认值 |
详细解释 |
| type |
比较类型 |
“size” |
(对select无效)”size”:表示比较长度 “value”:比较值。 |
| min |
最小长度/值 |
0 |
(对select无效) |
| max |
最大长度/值 |
99999999999999 |
(对select无效) |
| onerror |
发生错误的提示 |
“输入错误” |
|
| defaultvalue |
默认值 |
null |
能满足预设默认值的需求 |
|
| |
|
|
|
| CompareValidator： |
|
| 属性 |
属性名称 |
默认值 |
详细解释 |
| desID |
要比较控件的ID |
“” |
要跟源目标进行比较的目标ID |
| operateor |
比较符号 |
“=” |
一共有如下几种类型:=、!=、>、>=、<、<= |
| datatype |
数据类型 |
“string” |
目前只支持2种:”string”、”number” |
| onerror |
发生错误的提示 |
“输入错误” |
|
|
| |
|
|
|
| RegexValidator: |
|
| 属性 |
属性名称 |
默认值 |
详细解释 |
| regexp |
正则表达式 |
“” |
采用的是显式构造函数new RegExp(“pattern”[,”flags”]); 由于Javascript 中’\’ 被用作转义字符，所以在使用显示构造函数构造实例对象的时候，需要使用’\\’ 代替’\’ |
| param |
附加参数 |
“i” |
g：代表可以进行全局匹配。i：代表不区分大小写匹配。m：代表可以进行多行匹配。可以任意组合,当然也可以不加参数 |
| datatype |
数据类型 |
“string” |
“string”:自己写的表达式，”enum”:枚举名。具体请见demo3.htm，你可以自己修改附加 pageValidatorRegex.js里的枚举项目名和表达式。 |
| onerror: |
发生错误的提示 |
“输入错误” |
|
|
| |
|
|
|
| AjaxValidator: |
几乎所有的属性跟$.ajax()的属性一样，请参考$.ajax()函数的帮助 |
| 属性 |
属性名称 |
默认值 |
详细解释 |
| type |
请求的类型 |
“GET” |
“POST” 或 “GET” |
| url |
发送到的URL地址 |
“” |
|
| datatype |
返回的数据类型 |
“html” |
xml、html、script、json |
| data |
数据 |
“” |
|
| async |
是否以异步的方式发送 |
true |
|
| success |
当请求成功时调用的函数 |
null |
|
| processdata |
自动处理返回的数据为字符串 |
true |
在默认的情况下，如果data选项传进的数据是一个对象而不是字符串，将会自动地被处理和转换成一个查询字符串 |
| complete |
当请求完成时调用的函数 |
null |
|
| beforesend |
当请求前时调用的函数 |
null |
|
| error |
当请求失败时调用的函数 |
“请求失败” |
你可以自己定义这个错误，在error里自动打出 |
|
| |
| 公共函数: |
主要是设置全局参数和判断是否通过校验 |
| 函数名 |
函数说明 |
| jQuery.formValidator.initConfig |
参数：配置类型
| 属性 |
默认值 |
说明 |
| validatorGroup |
“1” |
你要针对哪个组进行配置 |
| alertMessage |
false |
是否弹出窗口 |
| onSuccess |
null |
该组校验通过后的回调函数,返回false，阻止表单的提交 |
| submitOnce |
false |
校验通过后，是否灰掉所有的提交按钮 |
| onError |
null |
该组校验失败后的回调函数 |
|
| jQuery.formValidator.PageIsValid |
一个参数： 不是配置类型
| validatorGroup |
“1” |
你要针对哪个组进行验证 |
|
| jQuery.formValidator.IsOneValid |
一个参数： 当时设置验证的表单元素ID。返回是否校验成功的信息。 |
| jQuery.formValidator.SetFailState |
function(“tipid”,”显示的信息”)在showword模式下，如果你的额外校验没有通过，你可以通过它来设置成失败信息和状态 |
| jQuery.formValidator.GetLength |
function(“表单元素id”)判断表单元素的选择长度(个数)checkbox或radiobutton表示选择的个数。select表示选择的selectedIndex值。其它的表示字符长度。 |
|
| |
|
|
|
| 问答： |
|
|
|
| 1、如何实现一个控件，根据不同的情况，实现不同的控制？ |
| 你只需要在你的不同种情况下，重新设置你的【一行代码】 |
| |
| 2、一个页面上我有几个tab页，如何实现每个Tab页上的控件单独校验？ |
| 每个Tab页上需要校验的控件，你在写【一行代码】的时候，显示的声明组号 |
| |
| 3、我采用的页面上文字问题的方式，点提交的时候，有校验未通过的，除了文字提示外，还可以再弹出窗口提示吗？ |
| 这个问题很简单，你只要设置改组的全局配置，jQuery.formValidator.initConfig({onError:function(){alert(“有部分校验没有通过，请看页面具体提示”);}}) |
| |
| 4、所有校验通过后，我还要再做别的判断可以吗？我自己的判断没有通过可以中断提交吗？ |
| 同样很简单，你页只需设置该组的全局配置，jQuery.formValidator.initConfig({onSuccess:function(){if(你的额外判断失败)return false;elsereturn true;}}) |
| |
| 5、我有一组的checkbox（radiobutton）如何设置校验？ |
| 你只需在该组的第一个checkbox上设置校验信息即可，具体请参考demo1里的范例如果你该组的第一个控件的ID ，你可以这么写:$(“sex_1”).InputValidator({…})如果你只知道该组的name，你可以这么写:$(“input:check[@name=’sex’]”).slice(0,1).InputValidator({…}) |
| |
| 6、我有2个表单元素，任意一个元素输入东西就算验证通过，如何写代码？比如要求输入中文名字和英文名字任意一个即算校验通过。 |
| 正在开发这个功能 |
| |
| 7、一个表单元素校验通过了，但是我想额外再进行其它的校验，出错要自定义错误，如何写代码？ |
| $(“#ewjy”).formValidator({onshow:”无论你输入什么，都会提示你额外校验出错，错误信息自定义”,onfocus:”至少输入一个字符”,oncorrect:”你怎么可能输入正确了，难道是 bug?”,onvalid:function(){$.formValidator.SetFailState(“ewjyTip”,”额外校验失败”);alert(“额外校验失败”);return false;}}).InputValidator({min:1,onerror:”这里至少要一个字符,请确认”}); |
| |
| 8、如何让赋了初始值的表单元素默认校验通过 |
| $(“#xueli”).formValidator({onshow:”请选择你的学历”,onfocus:”学历必须选择”,oncorrect:”谢谢你的配合”,defaultvalue:”b”}).InputValidator({onerror: “你是不是忘记选择学历了!”}).DefaultPassed(); |