//msg:提示信息;
//o:{obj:*,type:*,curform:*},
//obj指向的是当前验证的表单元素(或表单对象,验证全部验证通过,提交表单时o.obj为该表单对象),
//type指示提示的状态,值为1、2、3、4, 1:正在检测/提交数据,2:通过验证,3:验证失败,4:提示ignore状态,
//curform为当前form对象;
//cssctl:内置的提示信息样式控制函数,该函数需传入两个参数:显示提示信息的对象 和 当前提示的状态(既形参o中的type);
}
具体参见demo页。
tiptype不为1时,Validform会查找class为"Validform_checktip"的标签显示提示信息。tiptype=1时,会自动创建弹出框显示提示信息。
Validform_checktip和表单元素之间的位置关系,会根据tiptype的值有对应的结构,上面已经做了说明。
5.3版本开始,如果页面里没有显示出错信息的标签,会根据tiptype值自动创建Validform_checktip对象。
- ignoreHidden
可用值: true | false。
默认为false,当为true时对:hidden的表单元素将不做验证;
- dragonfly
可用值: true | false。
默认false,当为true时,值为空时不做验证;
- tipSweep
可用值: true | false。
默认为false, 5.3版中做了修正,在各种tiptype下, 为true时提示信息将只会在表单提交时触发显示,各表单元素blur时不会触发信息提示;
- label 5.3.1+
选择符
在没有绑定nullmsg时查找要显示的提示文字,默认查找".Validform_label"下的文字;
- showAllError
可用值: true | false。
默认为false,true:提交表单时所有错误提示信息都会显示;false:一碰到验证不通过的对象就会停止检测后面的元素,只显示该元素的错误信息;
- postonce
可用值: true | false。
默认为false,指定是否开启二次提交防御,true开启,不指定则默认关闭;
为true时,在数据成功提交后,表单将不能再继续提交。
- ajaxPost
可用值: true | false。
默认为false,使用ajax方式提交表单数据,将会把数据POST到config方法或表单action属性里设定的地址;
- datatype
传入自定义datatype类型,可以是正则,也可以是函数。
datatyp:{
“zh2-4”:/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/,
“phone”:function(gets,obj,curform,regxp){
//参数gets是获取到的表单元素值,
//obj为当前表单元素,
//curform为当前验证的表单,
//regxp为内置的一些正则表达式的引用。
//return false表示验证出错,没有return或者return true表示验证通过。
}
}
具体示例请参考demo页;
- usePlugin
目前已整合swfupload、datepicker、passwordstrength和jqtransform四个插件,在这里传入这些插件使用时需 要传入的参数。datepicker在Validform内调用时另外扩展了几个比较实用的参数,具体请参考demo页;
- beforeCheck(curform)
在表单提交执行验证之前执行的函数,curform参数获取到的是当前表单对象。
函数return false的话将不会继续执行验证操作;
- beforeSubmit(curform)
在表单验证通过,提交表单数据之前执行的函数,data参数是当前表单对象。
函数return false的话表单将不会提交;
- callback
在使用ajax提交表单数据时,数据提交后的回调函数。返回数据data是Json对象:
{“info”:“demo info”,“status”:“y”}
info: 输出提示信息,
status: 返回提交数据的状态,是否提交成功,"y"表示提交成功,"n"表示提交失败,在ajax_post.php文件返回数据里自定字符,主要用在 callback函数里根据该值执行相应的回调操作。你也可以在ajax_post.php文件返回更多信息在这里获取,进行相应操作;
如果不是ajax方式提交表单,传入callback,这时data参数是当前表单对象,回调函数会在表单验证全部通过后执行,然后判断是否提交表单,如 果callback里return false,则表单不会提交,如果return true或没有return,则会提交表单。
5.3版开始,ajax遇到服务端错误时也会执行回调,这时的data是{ status:**, statusText:**, readyState:**, responseText:** }
Validform对象[方法支持链式调用]
如示例 var demo=$(“.formsub”).Validform(),那么demo对象会有以下属性和方法可以调用:
tipmsg【object】
如:demo.tipmsg.s=“error! no message inputed.”;
通过该对象可以修改除 tit 以外的其他提示文字,这样可以实现同一个页面的不同表单使用不同的提示文字。
具体可修改的提示文字
$.Tipmsg={//默认提示文字;
tit:“提示信息”,
w:{
“*”:“不能为空!”,
“*6-16”:“请填写6到16位任意字符!”,
“n”:“请填写数字!”,
“n6-16”:“请填写6到16位数字!”,
“s”:“不能输入特殊字符!”,
“s6-18”:“请填写6到18位字符!”,
“p”:“请填写邮政编码!”,
“m”:“请填写手机号码!”,
“e”:“邮箱地址格式不对!”,
“url”:“请填写网址!”
},
def:“请填写正确信息!”,
undef:“datatype未定义!”,
reck:“两次输入的内容不一致!”,
r:“通过信息验证!”,
c:“正在检测信息…”,
s:“请{填写|选择}{0|信息}!”,
v:“所填信息没有经过验证,请稍后…”,
p:“正在提交数据…”
};
要修改tit(弹出框的标题文字)的话,可以这样:$.Tipmsg.tit=“Message Box”,则弹出框的标题文字会换成"Message Box"
注:5.3.2+
KaTeX parse error: Undefined control sequence: \* at position 15: .Tipmsg.w里,形如"\̲*̲6-16"的提示文字,里面的数….Tipmsg.w或Validform对象的tipmsg属性修改和扩展默认错误信息,如果你已经设置了"zh2-4"的提示信息是"2-4位 中文",那么"zh2-8"出错的信息就自动会是:“2-8位中文”。对于自定义的datatype,在扩展默认信息时,注意错误信息的名字要跟 datatype名字一样,如上面示例是:KaTeX parse error: Undefined control sequence: \[ at position 10: .Tipmsg.w\̲[̲"zh2-4"\]="2-4位….Tipmsg.w或Validform对象的tipmsg属性中扩展默认提示信息是个很好的选择。
5.3.1+
$.Tipmsg.s是用来指定在没有绑定nullmsg时的默认提示信息。“{0}“是会被找到的label参数指定的对象或 Validform_label里的文字替换掉的,”{填写|选择}“里的文字在绑定了"recheck"属性的表单元素上检测时是会不显示的,当前验证 对象是radio、checkbox或select时,会输出"选择”,是其他类型的元素时会输出"填写"和后面的"信息”。
具体示例请参见demo页。
dataType【object】
获取内置的一些正则:
{
“match”:/^(.+?)(\d+)-(\d+)$/,
“*”😕[\w\W]+/,
“*6-16”:/^[\w\W]{6,16}$/,
“n”:/^\d+$/,
“n6-16”:/^\d{6,16}$/,
“s”:/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]+$/,
“s6-18”:/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]{6,18}$/,
“p”:/^[0-9]{6}$/,
“m”:/^13[0-9]{9}KaTeX parse error: Undefined control sequence: \[ at position 4: |14\̲[̲0-9\]{9}|15\[0-…|18[0-9]{9}$/,
“e”:/^\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$/,
“url”:/^(\w+:\/\/)?\w+(\.\w+)+.*$/
}
addRule(rule)【返回值:Validform】
可以通过Validform对象的这个方法来给表单元素绑定验证规则,绑定验证类型中列出的附加属性都可以通过这个方法绑定。
demo.addRule([
{
ele:“#name”,
datatype:“s6-18”,
ajaxurl:“valid.php”,
nullmsg:“请输入昵称!”,
errormsg:“昵称至少6个字符,最多18个字符!”
},
{
ele:“#userpassword”,
datatype:“*6-16”,
nullmsg:“请设置密码!”,
errormsg:“密码范围在6~16位之间!”
},
{
ele:“#userpassword2”,
datatype:“*”,
recheck:“userpassword”,
nullmsg:“请再输入一次密码!”,
errormsg:“您两次输入的账号密码不一致!”
}
]);
其中ele是指定要绑定规则的对象,会在Validform对象下查找这些对象。
eq(n)【返回值:Validform】
获取Validform对象的第n个元素。
如你页面上有多个form的class都是formsub,执行上面的验证绑定,得到的demo对象就可以操作所有这些表单,如果你要对其中某个表单执行某些操作,那么就可以使用这个方法。
如demo.eq(0).resetForm(),重置第一个表单。
ajaxPost(flag,sync,url)【返回值:Validform】
以ajax方式提交表单。flag为true时,跳过验证直接提交,sync为true时将以同步的方式进行ajax提交。
参数url是5.3版新增,传入了url地址时,表单会提交到这个地址
如demo.ajaxPost(true),不做验证直接ajax提交表单。
abort()【返回值:Validform】
终止ajax的提交。
如执行上面的ajaxPost()之后,发现某些项填写不对,想取消表单提交,那么就可以执行这个操作:demo.abort()
submitForm(flag,url)【返回值:Validform】
以初始化时传入参数的设置方式提交表单,flag为true时,跳过验证直接提交。
参数url是5.3版新增,传入了url地址时,表单会提交到这个地址
如demo.submitForm(true),不做验证直接提交表单。
resetForm()【返回值:Validform】
重置表单。
如demo.resetForm(),重置表单到初始状态。
resetStatus()【返回值:Validform】
重置表单的提交状态。传入了postonce参数的话,表单成功提交后状态会设置为"posted",重置提交状态可以让表单继续可以提交。
如demo.resetStatus()
getStatus()【返回值:String】
获取表单的提交状态,normal:未提交,posting:正在提交,posted:已成功提交过。
如demo.getStatus()
setStatus(status)【返回值:Validform】
设置表单的提交状态,可以设置normal,posting,posted三种状态,不传参则设置状态为posting,这个状态表单可以验证,但不能提交。
如demo.setStatus(“posted”)
ignore(selector)【返回值:Validform】
忽略对所选择对象的验证,不传入selector则忽略所有表单元素。
如demo.ignore(“select,textarea,#name”),忽略Validform对象下所有select,textarea及一个id为"name"元素的验证。
unignore(selector)【返回值:Validform】
将ignore方法所忽略验证的对象重新获取验证效果,不传入selector则恢复验证所有表单元素。
如demo.unignore(“select,textarea,#name”),恢复Validform对象下所有select,textarea及一个id为"name"元素的验证。
check(bool,selector)【返回值:Boolean】
bool为true时则只验证不显示提示信息
对指定对象进行验证(默认验证当前整个表单),通过返回true,否则返回false(绑定实时验证的对象,格式符合要求时返回true,而不会等ajax的返回结果)
如demo.check(),验证当前整个表单,且只验证但不显示对错信息。
config(setup) 5.3+ 【返回值:Validform】
setup参数是一个对象。
如:
demo.config({
showAllError:true,
url:“这里指定提交地址”,
ajaxpost:{
//可以传入$.ajax()能使用的,除dataType外的所有参数;
},
ajaxurl:{
//可以传入$.ajax()能使用的,除dataType外的所有参数;
}
})
可用参数:tiptype等 5.3.2+:可以在这里设置初始化可用的所有参数
url:指定表单的提交路径,这里指定的路径会覆盖表单action属性所指定的路径
ajaxpost:表单以ajax提交时,可以在这里配置ajax的参数
ajaxurl:配置实时验证ajax的参数
①、config方法还能为已经初始化过的表单重新配置参数了!5.3.2+
如var demo=$(“.formsub”).Validform();
demo.config({tiptype:2});
demo下的各表单还能分别配置不同参数!
如demo.eq(0).config({tiptype:1,ajaxPost:true});
demo.eq(1).config({tiptype:1,callback:function(curform){my_method_to_submit_form(); return false;}});
②、执行config可以动态设置、添加参数,如:
demo.config({
url:“http://validform.rjboy.cn”
});
$(“.save”).click(function(){
demo.config({
ajaxpost:{
timeout:1000
}
});
});
那么在点击save按钮后,demo所对应的表单的config={
url:“http://validform.rjboy.cn”,
ajaxpost:{
timeout:1000
}
}
③、参数url的优先级:form表单的action所指定的提交地址会被config.url覆盖,
config.url会被config.ajaxpost.url覆盖,config.ajaxpost.url会被Validform对象的方法submitForm(flag,url)
和ajaxPost(flag,sync,url)里的url覆盖。
如果表单里没有指定action提交地址,那么就会提交到config.url设定的地址。
考虑到整个验证框架的逻辑,传入dataType参数不会起作用,不会被覆盖,ajax必须返回含有status值的json数据。
④、另外注意的是:传入的success和error方法里,能多获取到一个参数,如:
demo.config={
ajaxpost:{
url:“”,
timeout:1000,
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数前端工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上前端开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录大纲截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且后续会持续更新
如果你觉得这些内容对你有帮助,可以添加V获取:vip1024c (备注前端)
最后
资料过多,篇幅有限
CodeChina开源项目:【大厂前端面试题解析+核心总结学习笔记+真实项目实战+最新讲解视频】
自古成功在尝试。不尝试永远都不会成功。勇敢的尝试是成功的一半。
交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。**
深知大多数前端工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则几千的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
[外链图片转存中…(img-barexIdS-1711965385323)]
[外链图片转存中…(img-eOUD7sWV-1711965385323)]
[外链图片转存中…(img-2ICJqP6x-1711965385324)]
[外链图片转存中…(img-y9yjl25P-1711965385324)]
[外链图片转存中…(img-qpRNKeoM-1711965385325)]
[外链图片转存中…(img-ZOWQg4yv-1711965385325)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上前端开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录大纲截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且后续会持续更新
如果你觉得这些内容对你有帮助,可以添加V获取:vip1024c (备注前端)
[外链图片转存中…(img-JFRE1HYi-1711965385326)]
最后
[外链图片转存中…(img-zBfZVqFd-1711965385326)]
[外链图片转存中…(img-9HPk2S4q-1711965385327)]
资料过多,篇幅有限
CodeChina开源项目:【大厂前端面试题解析+核心总结学习笔记+真实项目实战+最新讲解视频】
自古成功在尝试。不尝试永远都不会成功。勇敢的尝试是成功的一半。