1 简介

　　validate.js包含三个主要的构造： FormValidator，InputValidator，BaseValidator构造会new一个对象，对有限属性进行覆盖：

　　FormValidator是表单的验证构造，需要两个参数，第一个为表单元素，第二个为构造的参数列表(是一个JSON对象，会覆盖掉该对象中的同名属性)。

　　InputValidator 是表单元素的验证构造,有三个参数，第一个参数为该对象的宿主对象(元素所在的form对象，如果传入Null则会自动查找所在form)，第二个参数为表单元素，第三个参数为构造属性(是一个JSON对象，会覆盖掉该对象中的同名属性)。

　　BaseValidator为所有验证规则的基础构造，构造包含两个参数，第一个参数为验证规则的宿主对象(一般为InputValidator)，第二个参数是验证规则的参数列表对象(是一个JSON对象，会覆盖掉该对象中的同名属性)。

　　在使用时不需要手动调用构造参数，框架已将构造过程嵌入到了JQuery对象中，只需要用JQuery查找到对象，然后调用elementValidator方法(或同名方法initValidator)就会根据元素类型(tagName是否form)获得相应的对象(FormValidator或InputValidator)，方法需要一个参数用来覆盖掉对象中的默认成员。

　　需要使用InputValidator对象的addValidator方法构造BaseValidator对象，addValidator包含两个参数第一个参数为验证规则名称(必须是已注册的验证规则)，第二个参数是用来覆盖掉验证规则对象默认成员的JSON对象，关于注册规则将在最后说明。

2. 使用方法

2.1 初始化验证的表单

　　在页面的load事件中调用$("#表单ID").elementValidator(或同名方法initValidator),该方法参数为JSON Object

　　$("#sForm").elementValidator({

　　autoSubmit : true,//验证通过后是否自动提交表单(默认为true,自动提交)

　　failStop:false,//验证表单项时 某一元素验证失败是否终止验证程序(默认为false,每次表单验证都会验证全部元素)

　　exceptionFail:true,//验证过程中出现异常是否标记为验证失败(默认为true)

　　beforeValidate:false,//在验证之前执行的方法,如果该方法返回false则不再进行验证,并返回false

　　onFail:function(callback){},//验证失败会调用的方法,默认是一个空方法

　　onVali:function(callback){}//验证通过会调用的方法,默认是一个空方法

　　});

　　//****参数不填均为默认值

2.2 初始化需要验证的表单项

　　在页面的load事件中调用$("#元素ID").elementValidator(或同名方法initValidator) ,该方法参数为JSON Object,调用该方法会返回一个InputValidator对象，然后通过该对象的addValidator(RuleName,{/*RuleOption*/})方法添加验证规则

　　(不需要的参数不要填写，填写之后便会覆盖掉默认的值,以下均为默认值)

　　$('#Email').initValidator({

　　autoBind ：true,//是否自动绑定验证到元素的事件(会绑定change,focus,blur,change和blur时会进行验证)

　　msgTarget ： 元素ID + "_tip",//验证反馈元素的ID,用来显示验证结果，默认为元素ID + "_tip"

　　readyMsg ： "",//初始状态消息

　　focusMsg： "",//获取焦点后的消息

　　validMsg ： "",//验证通过后的消息

　　waitMsg ： "",//等待状态的消息

　　errorMsg ： "",//验证错误的消息

　　againMsg ： "",//重试的消息

　　readyClass： 'validation-ready',//初始状态的CSS样式

　　errorClass ： 'validation-error',//错误状态的CSS样式

　　focusClass：'validation-focus',//获取焦点的CSS样式

　　validClass：'validation-valid',//验证通过的CSS样式

　　waitClass ： 'validation-wait',//等待状态的CSS样式

　　againClass ： 'validation-error',//需要重试的CSS样式

　　allowEmpty ： false，//是否允许为空，当设置为true时，如果元素的值未填则不会进行验证,并设置该元素的验证状态为通过

　　affected ：null,//affected元素的change事件会影响到该元素的状态，状态取决于affectState的值

　　affectState："ready",//默认为ready状态

　　showMsg : function(state, message) {//显示该元素验证消息的方法,会覆盖掉默认显示消息方法,如果使用默认的显示消息方法，请确保不要包含该条属性

　　message = message || this[state + "Msg"];

　　var msgTarget = $("#" + this.msgTarget);

　　msgTarget.removeClass().addClass(this[state + "Class"]).html(message);

　　},

　　}).addValidator('NotNull', {//添加非空验证

　　errorMsg : '请输入邮箱地址'

　　}).addValidator('Email', {//添加邮箱格式验证

　　errorMsg : '邮箱格式错误，请重新输入'

　　}).addValidator('URLValue', {//添加URL资源文本验证

　　url : 'validate',

　　sendData : {

　　'type' : 'email'

　　},

　　sendKey : 'Email',

　　eqValue : 'false',

　　errorMsg : '该邮箱已被注册，请重新输入'

　　});

2.3 默认已实现的验证规则

　　（1）NotNull (非空验证)

　　参数：

　　autoTrim 是否在验证前执行Trim操作(去除文本两端半角空格) 默认为false

　　（2）RegExp 正则表达式验证

　　参数：

　　autoTrim 是否在验证前执行Trim操作(去除文本两端半角空格) 默认为false

　　regex  正则表达式(字符串)

　　attr  可选的字符串，包含属性 "g"、"i" 和 "m"，分别用于指定全局匹配、区分大小写的匹配和多行匹配

　　（3）Email 邮箱格式验证

　　参数：

　　autoTrim 是否在验证前执行Trim操作(去除文本两端半角空格) 默认为false

　　errorMsg 默认："电子邮箱格式错误"

　　Regex 默认： "^[a-zA-Z0-9._-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)+$"

　　（4）Length 长度校验

　　参数：

　　min最小长度(-1为不限)

　　max最大长度(-1为不限)

　　lable提示时的标识名称(比如该值如果是”用户名”,当元素值不满足条件会提示：用户名长度应大于或小于xx个字符)

　　（5）Equals 对比校验

　　参数：

　　eqElement: '', //比较的元素(优先级大于eqValue)

　　eqValue: '', //比较的值(当eqElement不为空时不会比较该值)

　　（6）URLValue URL资源对比(该校验可以做页面 验证码,用户名是否存在等ajax校验)

　　参数：

　　isSync: false, //是否同步模式

　　url: "", //URL

　　method: "post", //提交方式

　　sendData: {}, //提交的值

　　sendKey: "", //提交URL请求时，使用的数据name值

　　eqValue: "", //对比值-将请求URL得到的文本与该值对比

　　（7）Attr 属性校验(校验元素的属性值)

　　参数：

　　attr: "value", //属性名称

　　eqValue: null, //属性对比值

　　val: function(input){//默认的获取属性值的方法

　　return $(input).attr(this.attr);

　　}

　　（8）Number 数值验证(数值大小不能超出JS的数值范围-1.7976931348623157e+308 ~ 1.7976931348623157e+308)

　　参数：

　　onlyInt: false, //是否验证为整数

　　min: null, //最小值(默认null为不限制)

　　max: null, //最大值(默认null为不限制)

　　（9）Int 整数验证(继承至Number 验证)

　　属性：

　　onlyInt: true

　　（10）Function Function验证

　　参数：

　　func: "",字符串或function对象，该方法需要返回Boolean值true或false

　　root: window,当function属性为字符串的时候将会在该对象下根据func的值查找function，如果查找不到则提示：验证方法(" + func + ")未找到

2.4 注册验证规则

　　使用$.validation.regRules方法注册验证规则,该方法有三个参数：

　　参数1：验证规则名称，比如：Email,Number，NotNull；

　　参数2：验证规则属性，需要包含 doValidate: function(input, waitToDo){}的函数实现，该方法返回true,false,或'wait','again'表示验证成功,验证失败,等待,重试，该方法包含两个参数,参数input表示验证的页面元素，waitToDo是在异步验证回调时使用；

　　参数3(可选)：该验证规则继承来源，表示该验证规则继承至另一个验证规则，可以使用this.superDoValidate得到父验证规则的验证方法,并可以使用父验证规则的属性。

　　举例：URLValue验证，

2.5 页面使用示例

　　ZAS注册页面