`

表单校验组件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调用外部插件

转自:http://blog.csdn.net/zhangdaiscott/article/details/26379431
分享到:
评论

相关推荐

    jQuery表单验证插件Validform

    此外,Validform的API提供了丰富的接口供开发者进行二次开发和扩展,如`resetForm()`用于清空表单数据,`getType()`获取字段验证类型等。 总的来说,jQuery表单验证插件Validform凭借其强大的功能和易用性,成为了...

    jquery表单验证插件Validform框架demo实例代码下载

    **二、Validform的验证规则** Validform支持多种内置验证规则,如: - `smin-max`:字符串长度范围,例如`datatype="s2-16"`表示2到16个字符。 - `nmin-max`:数字范围,例如`datatype="n1-100"`表示1到100的整数...

    jquery 表单验证插件Validform插件制作一行代码搞定整站的jquery表单验证

    jQuery Validform是一款强大的表单验证插件,它以其简洁的API和高度可定制化的特点,在前端开发中广受欢迎。本文将详细介绍如何使用jQuery Validform插件来实现高效、灵活的表单验证。 **一、Validform简介** ...

    Jquery表单验证插件–Validform

    **jQuery表单验证插件Validform详解** 在Web开发中,表单验证是必不可少的一环,它能够确保用户输入的数据符合预设的规则,从而提高数据的准确性和系统的稳定性。Validform是一款基于jQuery的轻量级表单验证插件,...

    表单验证 ValidForm

    **表单验证 ValidForm** 在Web开发中,用户输入的数据验证是至关重要的,因为它确保了数据的准确性和安全性。ValidForm是一款强大的JavaScript表单验证插件,它专注于提供灵活、高效的前端验证解决方案。通过...

    Validform前端表单验证

    Validform是一款强大的前端表单验证框架,主要用于提升用户体验和数据安全性,确保用户在网页表单中输入的数据符合预设的规则。它具有丰富的验证规则、灵活的API接口和高度自定义的功能,使得开发者能够轻松地对表单...

    表单验证插件Validform

    **表单验证插件Validform** Validform是一款广泛应用于前端开发中的强大表单验证插件,主要用于提升用户体验,确保用户输入的数据符合预设的规则,从而避免无效或错误的数据提交到服务器。它基于JavaScript和jQuery...

    validform表单验证

    ValidForm是一款强大的JavaScript表单验证插件,专为前端开发者设计,用于实现高效、便捷的表单数据验证。它的核心功能在于提供了一种简洁的方法,让开发者能够在用户提交表单前,对输入的数据进行实时检查,确保...

    Validform_v5.3.2

    2. **验证规则**:Validform支持多种内置验证规则,如非空、邮箱、电话号码、URL、数字、日期等。开发者可以通过简单的配置,比如`require`、`email`、`mobile`等,定义字段的验证类型。 3. **自定义验证**:除了...

    validform demo

    Validform是一款强大的JavaScript表单验证框架,它旨在简化前端数据验证的过程,提高用户体验。这款工具提供了丰富的验证规则和灵活的配置选项,适用于各种复杂的表单场景。在"validform demo"中,我们可以深入理解...

    Validform-v5.3.2 demo及引用的Validform-v5.3.2-min.js

    Validform 是一个强大的JavaScript表单验证框架,专为前端开发者设计,用于简化和增强网页表单的数据验证。在"Validform_v5.3.2 demo"中,我们可以通过实例了解到如何使用这个版本的Validform来创建高效且用户体验...

    validform表单验证的实现方法

    Validform是一款表单验证的插件,它能够将验证条件和验证提示信息绑定到表单的每个元素上。使用Validform可以简化表单验证的过程,通过设定不同的验证规则来确保用户提交的数据符合预期要求。Validform表单验证插件...

    jquery特效插件Validform制作一行代码搞定整站的表单验证

    Validform是基于jQuery的一个高效、强大的表单验证插件,它允许开发者通过一行简单的代码就能实现全站的表单验证。 Validform插件的亮点在于其高度可定制性和灵活性。它可以轻松地处理各种复杂的验证场景,如邮箱...

    使用Validform的小例子程序

    Validform是一款强大的JavaScript表单验证框架,它使得前端开发者能够轻松地实现对用户输入数据的实时验证,确保数据的完整性和正确性。在"使用Validform的小例子程序"中,我们可以学习如何有效地应用Validform来...

    Validform_v5.1

    Validform_v5.1 是一个专门用于JavaScript表单验证的库,它的主要目的是帮助开发者以简洁高效的方式实现前端数据校验。在Web开发中,表单验证是必不可少的一部分,它确保用户输入的数据符合预设的规则,从而提高用户...

    validform_v5.3.2 远程验证支持跨域

    Validform_v5.3.2 是一款强大的前端表单验证插件,专注于提供高效、便捷的验证解决方案。在5.3.2版本中,它引入了一个重要的特性:远程验证支持跨域。这一特性使得开发者能够轻松地实现对用户输入数据的实时、服务器...

    Validform_v5.3.2_min.js好用的表单验证工具

    Validform_v5.3.2_min.js好用的表单验证工具,实现多种验证,数字、电话、邮箱

    Validform_v5.3.2.rar

    2. **实时反馈**:该库能够实时显示验证结果,用户在填写表单时即可看到错误提示,提升用户体验。这减少了用户反复提交表单的次数,提高了表单填写的成功率。 3. **易于使用**:Validform使用简洁的API,使得在HTML...

    validform总结文档

    Validform是一款专门用于Web表单验证的JavaScript插件,它极大地简化了开发者在处理大量输入字段时的验证逻辑。该插件通过对JavaScript进行轻量级封装,实现了对表单验证一系列操作的高度自动化,从而显著提高了开发...

    Validform表单验证总结篇

    近期项目里用到了表单的验证,选择了Validform_v5.3.2。 先来了解一下一些基本的参数: 通用表单验证方法: Demo: $(".demoform").Validform({//$(".demoform")指明是哪一表单需要验证,名称需加在form表单上; ...

Global site tag (gtag.js) - Google Analytics