表单组件使用说明.docx

表单组件使用说明是用前需要引入两个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.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、使用方法: 表单验证方法的调用格式：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是当前验证元素的值，obj是当前元素的element对象，form是当前验证的表单。方法返回true通过验证，方法返回false不通过验证。注意当需要验证是否为空时，就不用配这个参数了，只需要在Config中配置ignoreNull为false就可以了。例如: actorName, 请填写你的常用邮箱！, errMsgBox:emailerrmsg, ignoreNull:false, validateEvent:blur 这里就没有写validateFunctionconfigStr针对当前正在验证的表单元素的配置字符串，配置字符串格式为json。例如：errMsgBox: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)配置串格式为json。例如：onSubmitCallBack:function(queryString)alert(提交字符串+queryString)。配置串参数说