如果ajax校验通过,会在该元素上绑定validform_valid值为true。可以通过设置该值来控制验证能不能通过,如验证码的验证,第一次验 证通过后,不小心右点击了下验证码图片,验证码换了,但是仍然指示这个对象已经通过了验证,这时可以手动调整该值:$(“#name”) [0].validform_valid=“false”。
怎样设置ajax的参数,具体可以查看Validform对象的config方法。
- plugin
指定需要使用的插件。
5.3版开始,对于日期、swfupload和密码强度检测这三个插件,绑定了plugin属性即可以初始化对应的插件,可以不用在validform初始化时传入空的usePlugin了。
如,你要使用日期插件,5.3之前版本需要这样初始化:
$(“.demoform”).Validform({
usePlugin:{
datepicker:{}
}
});
5.3版开始,不需要传入这些空对象了,只需在表单元素上绑定plugin="datepicker"就可以,初始化直接这样:
$(“.demoform”).Validform();
初始化参数说明
所有可用参数如下:
1 2
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 |
$(".demoform").Validform({ btnSubmit:"#btn_sub", btnReset:".btn_reset", tiptype:1, ignoreHidden:false, dragonfly:false, tipSweep:true, label:".label", showAllError:false, postonce:true, ajaxPost:true, datatype:{ "*6-20": /^[^\s]{6,20}$/, "z2-4" : /^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/, "username":function(gets,obj,curform,regxp){ //参数gets是获取到的表单元素值,obj为当前表单元素,curform为当前验证的表单,regxp为内置的一些正则表达式的引用; var reg1=/^[\w\.]{4,16}$/, reg2=/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,8}$/; if(reg1.test(gets)){return true;} if(reg2.test(gets)){return true;} return false; //注意return可以返回true 或 false 或 字符串文字,true表示验证通过,返回字符串表示验证失败,字符串作为错误提示显示,返回false则用errmsg或默认的错误提示; }, "phone":function(){ // 5.0 版本之后,要实现二选一的验证效果,datatype 的名称 不 需要以 "option_" 开头; } }, usePlugin:{ swfupload:{}, datepicker:{}, passwordstrength:{}, jqtransform:{ selector:"select,input" } }, beforeCheck:function(curform){ //在表单提交执行验证之前执行的函数,curform参数是当前表单对象。 //这里明确return false的话将不会继续执行验证操作; }, beforeSubmit:function(curform){ //在验证成功后,表单提交前执行的函数,curform参数是当前表单对象。 //这里明确return false的话表单将不会提交; }, callback:function(data){ //返回数据data是json对象,{"info":"demo info","status":"y"} //info: 输出提示信息; //status: 返回提交数据的状态,是否提交成功。如可以用"y"表示提交成功,"n"表示提交失败,在ajax_post.php文件返回数据里自定字符,主要用在callback函数里根据该值执行相应的回调操作; //你也可以在ajax_post.php文件返回更多信息在这里获取,进行相应操作; //ajax遇到服务端错误时也会执行回调,这时的data是{ status:**, statusText:**, readyState:**, responseText:** }; //这里执行回调操作; //注意:如果不是ajax方式提交表单,传入callback,这时data参数是当前表单对象,回调函数会在表单验证全部通过后执行,然后判断是否提交表单,如果callback里明确return false,则表单不会提交,如果return true或没有return,则会提交表单。 }}); |
参数说明:【所有参数均为可选项】
-
必须是表单对象执行Validform方法,示例中".demoform"就是绑定在form元素上的class名称;
-
btnSubmit
指定当前表单下的哪一个按钮触发表单提交事件,如果表单下有submit按钮时可以省略该参数。示例中".btn_sub"是该表单下要绑定点击提交表单事件的按钮;
- btnReset
".btn_reset"是该表单下要绑定点击重置表单事件的按钮;
- tiptype
可用的值有:1、2、3、4和function函数,默认tiptype为1。 3、4是5.2.1版本新增
1=> 自定义弹出框提示;
2=> 侧边提示(会在当前元素的父级的next对象的子级查找显示提示信息的对象,表单以ajax提交时会弹出自定义提示框显示表单提交状态);
3=> 侧边提示(会在当前元素的siblings对象中查找显示提示信息的对象,表单以ajax提交时会弹出自定义提示框显示表单提交状态);
4=> 侧边提示(会在当前元素的父级的next对象下查找显示提示信息的对象,表单以ajax提交时不显示表单的提交状态);
如果上面的4种提示方式不是你需要的,你可以给tiptype传入自定义函数。通过自定义函数,可以实现你想要的任何提示效果:
tiptype:function(msg,o,cssctl){
//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】
小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级前端工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Web前端开发全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频
如果你觉得这些内容对你有帮助,可以添加下面V无偿领取!(备注:前端)
最后前端到底应该怎么学才好?
如果你打算靠自己摸索自学,那么你首先要了解学习前端的基本大纲,这是你将要学习的主要内容,理解以及掌握好这些内容,便可以找到一份初级的前端开发工作。你还需要有一套完整的前端学习教程,作为初学者最好的方式就是看视频教程学习,初学者容易理解接受。
不要选择买书学习,这样的方式没有几个人能学会,基本都是看不下去书,也看不懂书。如果喜欢看书的学弟,可以买一些经典的书籍作为辅助即可,主要还是以看教程为主。每天抽出固定几个小时学习,做好长期学习的准备。学习编程并不是每天光看视频,你学习编程最重要的目的是为了编写软件产品,提供给大众使用,所以用手写出代码实现功能才是我们要做的事情。
开源分享:【大厂前端面试题解析+核心总结学习笔记+真实项目实战+最新讲解视频】
笔记+真实项目实战+最新讲解视频】](https://bbs.csdn.net/topics/618166371)**