欢迎来到天天文库
浏览记录
ID:12851569
大小:22.48 KB
页数:3页
时间:2018-07-19
《表单组件使用说明》由会员上传分享,免费在线阅读,更多相关内容在教育资源-天天文库。
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)[验证串1],(2)[验证串2],(2)[验证串3],(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时触发的回调方法,这个方法有一个输出参数,这个输出参数是个字符串,返回表单发送的数据。
此文档下载收益归作者所有