|
|
开发指南专题十：JEECG微云快速开发平台--表单校验组件ValidForm
10.4Validform对象[方法支持链式调用]
如示例 var demo=$(".formsub").Validform()，那么demo对象会有以下属性和方法可以调用：
tipmsg【object】
如：demo.tipmsg.s="error! no messageinputed.";
通过该对象可以修改除 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:"请填入信息！",
s_auto:"请{填写}{0}！",
v:"所填信息没有经过验证，请稍后…",
p:"正在提交数据…"
};
要修改tit（弹出框的标题文字）的话，可以这样：$.Tipmsg.tit="MessageBox"，则弹出框的标题文字会换成"Message Box"。
注：5.3+
$.Tipmsg.w里，形如"*6-16"的提示文字，里面的数字是会被替换的。如绑定datatype="*2-18"，那它默认的出错信息就会是"请填写2到18位任意字符！"，可以通过$.Tipmsg.w这个对象修改和扩展默认错误信息，如果你已经设置了"zh2-4"的提示信息是"2-4位中文",那么"zh2-8"出错的信息就自动会是："2-8位中文"。对于自定义的datatype，在扩展默认信息时，注意错误信息的名字要跟datatype名字一样，如上面示例是：$.Tipmsg.w["zh2-4"]="2-4位中文"。对于多页面或一个页面多表单有相同datatype来说，在$.Tipmsg.w中扩展默认提示信息是个很好的选择。目前只能通过$.Tipmsg.w扩展，还不能使用Validform对象的tipmsg属性来扩展。
$.Tipmsg.s_auto是用来指定在没有绑定nullmsg，且指定了标签Validform_label时的默认提示信息。"{0}"是会被找到的Validform_label里的文字替换掉的，"{填写}"里的文字在绑定了"recheck"属性的表单元素上检测时是会不显示的。
具体示例请参见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}$|14[0-9]{9}|15[0-9]{9}$|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({
url:"这里指定提交地址",
ajaxpost:{
//可以传入$.ajax()能使用的，除dataType外的所有参数;
},
ajaxurl:{
//可以传入$.ajax()能使用的，除dataType外的所有参数;
}
})
可用参数：
url：指定表单的提交路径，这里指定的路径会覆盖表单action属性所指定的路径
ajaxpost：表单以ajax提交时，可以在这里配置ajax的参数
ajaxurl：配置实时验证ajax的参数
(1) 执行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
}
}
(2) 参数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设定的地址。
(3) 考虑到整个验证框架的逻辑，传入dataType参数不会起作用，不会被覆盖，ajax必须返回含有status值的json数据。
另外注意的是：传入的success和error方法里，能多获取到一个参数，如：
demo.config={
ajaxpost:{
url:"",
timeout:1000,
...,
success:function(data,obj){
//data是返回的json数据;
//obj是当前表单的jquery对象;
},
error:function(data,obj){
//data是{ status:**, statusText:**, readyState:**, responseText:** };
//obj是当前表单的jquery对象;
}
},
ajaxurl:{
success:function(data,obj){
//data是返回的json数据;
//obj是当前正做实时验证表单元素的jquery对象;
//注意：5.3版中，实时验证的返回数据须是含有status值的json数据！
//跟callback里的ajax返回数据格式统一，建议不再返回字符串"y"或"n"。目前这两种格式的数据都兼容。
}
}
}
10.5调用外部插件
文件上传 - swfupload
选择文件后立即上传
表单验证通过后上传文件
密码强度检测 - passwordStrength
密码强度提示与验证提示同时显示
在符合验证要求时才有密码强度提示
日期控件- datePicker
默认效果
选择日期后执行回调函数
表单美化- jqtransform
默认对所有元素美化
美化指定的表单元素
10.6Validform的公用对象
$.Datatype
可以通过$.Datatype对象来扩展datatype类型。
如$.Datatype.zh=/^[\u4E00-\u9FA5\uf900-\ufa2d]{1,}$/
$.Tipmsg
可以通过$.Tipmsg对象来修改默认提示文字。具体可修改的提示文字请查看Validform对象的tipmsg属性。
如果Validform对象的tipmsg属性没有找到相关的提示信息，那么就会到$.Tipmsg中查找对应提示文字。
如$.Tipmsg.tit="msg box"; //设置默认弹出框的标题文字。
$.Showmsg(msg)
调用Validform自定义的弹出框。
参数msg是要显示的提示文字。
如$.Showmsg("这是提示文字");//如果不传入信息则不会有弹出框出现，像$.Showmsg()这样是不会弹出提示框的。
$.Hidemsg()
关闭Validform自定义的弹出框。
如$.Hidemsg()
|
|
窥视卡
雷达卡
发表于 2014-5-22 22:55:50
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
千斤顶
显身卡
