表单组件使用说明

《表单组件使用说明》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、表单组件使用说明是用前需要引入两个JavaScript文件:1、表单序列化：JTK.Form.formQuery(formId);1.1、参数formId为表单的id。1.2、功能说明：返回表单发送的数据，常用于ajax提交。2、表单验证：JTK.Form.formQuery(formId);2.1、参数formId为表单的id2.2、功能说明:2.1.1实现表单验证功能和验证方法分离，这样做的好处是可以随时随意加入新的验证方法,

2、并且验证方法还可以独立使用。2.1.2验证方法统一放在../Validate中，一个验证方法放一个文件。2.1.3能对指定的多个字段进行验证。2.1.4能够自定义单个字段的验证方法。2.1.5能够为校验元素绑定处理事件。2.1.6能够在同一元素上绑定多个验证方法,并自定义消息的提示方式与提示位置。2.1.7当验证失败时，可定义默认的消息提示方式(提示方式可以在回调方法中实现或在指定div中显示错误信息)。2.1.8当验证失败时，可选择是否自动聚焦到元素。2.1.9当验证成功时，可返回表单的提交字符串。2.1.10表单元素既可传入ID也可传入name，name比ID要优先考虑。2.3

3、、使用方法:表单验证方法的调用格式：var返回结果=JTK.FORM.validate(fromId,(1)[验证串１],(2)[验证串２],(2)[验证串３],(2)…,(2)[验证串n],(2){配置串}(3));参数说明：(1)fromId:表单的id。(2)[验证串]：语法格式：[inputName,errMsg,validateFunction,configStr]。inputName表单元素的name或id。errMsg当验证返回失败时显示的错误信息。validateFunction校验方法。这个方法有3个输出参数，分别是value,obj,form。Value是当前验

4、证元素的值，obj是当前元素的element对象，form是当前验证的表单。方法返回true通过验证，方法返回false不通过验证。注意当需要验证是否为空时，就不用配这个参数了，只需要在Config中配置ignoreNull为false就可以了。例如:['actorName','请填写你的常用邮箱！',{errMsgBox:"emailerrmsg",ignoreNull:false,validateEvent:"blur"}]这里就没有写validateFunctionconfigStr针对当前正在验证的表单元素的配置字符串，配置字符串格式为json。例如：{errMsgBox:

5、"emailerrmsg",ignoreNull:false,validateEvent:"blur"}。配置参数说明：errMsgBox：显示错误信息的element对象或id。ignoreNull：忽略空，可选值为true或false。validateEvent：除了submit事件的其它验证事件。callback：自定义验证失败提示信息，优先级要比errMsg高。比如你不想在某div中显示提示信息，也不想alert的时候调用，这个回调方法有3个输出参数，分别是msg,obj,form。Msg是校验失败的提示信息，obj是校验对象，form是当前作用的表单。(3){配置串}格式

6、为json。例如：{onSubmitCallBack:function(queryString){alert("提交字符串"+queryString)}}。配置串参数说明：onSubmitCallBack是当验证成功之后表单submit时触发的回调方法,这个方法有一个输出参数，这个输出参数是个字符串，返回表单发送的数据。