zoukankan      html  css  js  c++  java
  • 基于jQuery的表单验证插件:jValidate

    网上基于jQuery的表单验证插件已有很多,但是这个轮子我还是继续做一个,因为这个表单验证插件是从我以前的个人JS框架移值过来的(我已慢慢投入jQuery的怀抱),并且它的验证规则书写方式也许会让你眼前一亮。

    网上的各类表单验证插件的验证规则都是写在脚本里的,但我的插件的验证规则却是写在表单元素的属性里的。如下面的例子:

    <input name="name" type="text" id="name" size="30" jvpattern="^.+$" jverrortip="请输入正确的姓名." jvtipid="spt_name" jvmethod="checkname" />
    <span id="spt_name" class="normaltips" jverrorclass="errortips" jvcorrectclass="correcttips"></span>

     注意看上面代码中以“jv“开头的各种属性名,这些都是表单验证插件需要用的属性值。其中各属性代表的意思请阅读以下表:

    1、form表格控件元素可使用的属性

    属性名 说明
    jvpattern 用来验证控件值是否正确的正则表达式。(可不定义此属性)
    jvcompareid 需要与当前控件进行值相等比较的其它控件id。(可不定义此属性)
    jvrequired 表明当前控件值是否是必须的,也即是否允许当前控件值为空。如不定义此属性则默认为不可空,如果值为false或0则允许为空。(可不定义此属性)
    jvmethod

    定义需要进行额外验证的方法。(可不定义此属性)

    此属性值如果定义,则不需要输写“括号”,并且函数原型为:

    xx function(item){

        //代码

       

        //true表示验证成功,false表示验证失败。

        return true/false;

        //或者带错误消息的返回

        return {result:true/false, message:'错误消息'};

    }

    其中item参数是当前控件对象的jQuery实例。

    jvtipid

    显示验证提示信息的控件id。(可不定义此属性)

    注:如果不定义此属性,并且未定义onerror或oncorrect函数则默认为alert提示

    jverrortip 当验证失败时要显示的提示信息。(可不定义此属性)
    jvcorrecttip 当验证成功时要显示的提示信息。(可不定义此属性)
    jvfocuson 当验证失败后是否需要将光标移到控件上。(可不定义此属性)

     控件上必须定义:jvpattern、jvmethod、jvcompareid 三者之中的一个或多个,否则插件将不对对应的控件进行验证。

    2、tip提示控件元素可使用的属性:tip提示控件即是某个表单控件jvtipid指定的控件。

    属性名 说明
    jvnormalclass 正常情况下显示提示信息时采用的css样式的classname。(可不定义此属性)
    jvcorrectclass 验证成功后显示提示信息时采用的css样式的classname。(可不定义此属性)
    jverrorclass 验证失败后显示提示信息时采用的css样式的classname。(可不定义此属性)

    当控件规则设置好后就可以直接激活调用jValidate,以便当表单进行submit提交前,进行验证检查。

    示例: 

    $('form').jValidate();

    或者带参数的调用: 

    $('form').jValidate({
     blurvalidate : true,
     isbubble : false,
     onerror : function(item,form){
      $.jMessageBox.show('错误', item.attr('jverrortip'));
     }
    });

    可设置的参数请阅读下表:

    参数名 说明
    isbubble

    是否允许“冒泡”,也即是否允许逐个检查各控件值,如果值为true,则会逐一检查验证所有已设置验证规则的控件;如果值为false则当有一个控件值验证失败(不符合条件)后,将退出后续控件的检查。默认值为false

    注:如果提示信息是以弹出窗口方式显示的,建议将此值设置为false,以免一下子弹出较多提示,引起用户反感。

    blurvalidate 设置当个个控件失去焦点后是否需要即时检查验证。默认值为false。
    emptytip 是否允许空提示。也即是当没有提示信息可显示时,是否还允许提示控件改变css类。默认值为false
    validation 是否进行验证返回。 如果值为true则将进行直接验证,并返回验证结果,而非对象,默认值为false
    validationOnSubmit 是否需要在form表单提交时(submit事件发生时)进行验证,默认值为true
    focusOnError 在某个表单控件验证有错误时是否需要聚焦,默认值为true
    focusOnBlurError 在某个表单控件在失去焦点时验证有错误时是否需要聚焦,默认值为false
    oncorrect

    当控件值验证成功时调用处理的方法,如果未定义则采用默认行为。函数原型:

    function(item, form){

       //代码

    }

    其中参数item: 表示当前控件的jQuery实例; form : 表示控件所在的表单实例

    onerror

    当控件值验证失败时调用处理的方法,如果未定义则采用默认行为。函数原型:

    function(item, form){

       //代码

    }

    其中参数item: 表示当前控件的jQuery实例; form : 表示控件所在的表单实例

    示例截图:

    源码下载:(压缩包附带jMessageBox示例,关于jMessageBox请参考此文)

    /Files/kingthy/jvalidate.zip

    当前版本:v1.0.2

  • 相关阅读:
    Running ASP.NET Applications in Debian and Ubuntu using XSP and Mono
    .net extjs 封装
    ext direct spring
    install ubuntu tweak on ubuntu lts 10.04,this software is created by zhouding
    redis cookbook
    aptana eclipse plugin install on sts
    ubuntu open folderpath on terminal
    ubuntu install pae for the 32bit system 4g limited issue
    EXT Designer 正式版延长使用脚本
    用 Vagrant 快速建立開發環境
  • 原文地址:https://www.cnblogs.com/kingthy/p/jValidate.html
Copyright © 2011-2022 走看看