Bootstrap和JQuery.validate表单校验

超、凢脫俗 2022-06-17 00:29 364阅读 0赞

## 一、引入必要文件 ##

下载地址：([https://github.com/nghuuphuoc/bootstrapvalidator/archive/v0.4.5.zip][https_github.com_nghuuphuoc_bootstrapvalidator_archive_v0.4.5.zip])

## 二、编写HTML ##

在表单中，若对某一字段想添加验证规则，默认需要以`<div class=”form-group”></div>`包裹（对应错误提示会根据该class值定位），内部`<input class="form-control" />`标签必须有name属性值，此值为验证匹配字段。

注：该值不是绝对的，也可以通过js手动指定错误提示位置和验证的输入框（后续会讲解到）。

<form class="form-horizontal">
        <div class="form-group">
            <label class="col-lg-3 control-label">Username</label>
            <div class="col-lg-9">
                <input type="text" class="form-control" name="username" />
            </div>
        </div>
        <div class="form-group">
            <label class="col-lg-3 control-label">Email address</label>
            <div class="col-lg-9">
                <input type="text" class="form-control" name="email" />
            </div>
        </div>
    </form>
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
       10
       11
       12
       13
       14
      
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
       10
       11
       12
       13
       14

## 三、添加验证规则 ##

1、添加到HTML上

<div class="form-group">
        <label class="col-lg-3 control-label">Username</label>
        <div class="col-lg-5">
            <input type="text" class="form-control" name="username"
                data-bv-message="The username is not valid"
    
                required
                data-bv-notempty-message="The username is required and cannot be empty"
    
                pattern="[a-zA-Z0-9]+"
                data-bv-regexp-message="The username can only consist of alphabetical, number" />
        </div>
    </div>
    
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
       10
       11
       12
       13
       14
      
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
       10
       11
       12
       13
       14

2、添加到js上

注：以下参数上面的赋值都为默认值，不添加该参数即使用默认值

$(formSelector).bootstrapValidator({
        /** * 指定不验证的情况 * 值可设置为以下三种类型： * 1、String ':disabled, :hidden, :not(:visible)' * 2、Array 默认值 [':disabled', ':hidden', ':not(:visible)'] * 3、带回调函数 [':disabled', ':hidden', function($field, validator) { // $field 当前验证字段dom节点 // validator 验证实例对象 // 可以再次自定义不要验证的规则 // 必须要return，return true or false; return !$field.is(':visible'); }] */
        excluded: [':disabled', ':hidden', ':not(:visible)'],
        /** * 指定验证后验证字段的提示字体图标。（默认是bootstrap风格） * Bootstrap 版本 >= 3.1.0 * 也可以使用任何自定义风格，只要引入好相关的字体文件即可 * 默认样式 .form-horizontal .has-feedback .form-control-feedback { top: 0; right: 15px; } * 自定义该样式覆盖默认样式 .form-horizontal .has-feedback .form-control-feedback { top: 0; right: -15px; } .form-horizontal .has-feedback .input-group .form-control-feedback { top: 0; right: -30px; } */
        feedbackIcons: {
            valid: 'glyphicon glyphicon-ok',
            invalid: 'glyphicon glyphicon-remove',
            validating: 'glyphicon glyphicon-refresh'
        },
        /** * 生效规则（三选一） * enabled 字段值有变化就触发验证 * disabled,submitted 当点击提交时验证并展示错误信息 */
        live: 'enabled',
        /** * 为每个字段指定通用错误提示语 */
        message: 'This value is not valid',
        /** * 指定提交的按钮，例如：'.submitBtn' '#submitBtn' * 当表单验证不通过时，该按钮为disabled */
        submitButtons: 'button[type="submit"]',
        /** * submitHandler: function(validator, form, submitButton) { * //validator: 表单验证实例对象 * //form jq对象 指定表单对象 * //submitButton jq对象 指定提交按钮的对象 * } * 在ajax提交表单时很实用 * submitHandler: function(validator, form, submitButton) { // 实用ajax提交表单 $.post(form.attr('action'), form.serialize(), function(result) { // .自定义回调逻辑 }, 'json'); } * */
        submitHandler: null,
        /** * 为每个字段设置统一触发验证方式（也可在fields中为每个字段单独定义），默认是live配置的方式，数据改变就改变 * 也可以指定一个或多个（多个空格隔开） 'focus blur keyup' */
        trigger: null,
        /** * Number类型 为每个字段设置统一的开始验证情况，当输入字符大于等于设置的数值后才实时触发验证 */
        threshold: null,
        /** * 表单域配置 */
        fields: {
            //多个重复
            <fieldName>: {
                //隐藏或显示 该字段的验证
                enabled: true,
                //错误提示信息
                message: 'This value is not valid',
                /** * 定义错误提示位置 值为CSS选择器设置方式 * 例如：'#firstNameMeg' '.lastNameMeg' '[data-stripe="exp-month"]' */
                container: null,
                /** * 定义验证的节点，CSS选择器设置方式，可不必须是name值。 * 若是id，class, name属性，<fieldName>为该属性值 * 若是其他属性值且有中划线链接，<fieldName>转换为驼峰格式 selector: '[data-stripe="exp-month"]' => expMonth */
                selector: null,
                /** * 定义触发验证方式（也可在fields中为每个字段单独定义），默认是live配置的方式，数据改变就改变 * 也可以指定一个或多个（多个空格隔开） 'focus blur keyup' */
                trigger: null,
                // 定义每个验证规则
                validators: {
                    //多个重复
                    //官方默认验证参照 http://bv.doc.javake.cn/validators/
                    // 注：使用默认前提是引入了bootstrapValidator-all.js
                    // 若引入bootstrapValidator.js没有提供常用验证规则，需自定义验证规则哦
                    <validatorName>: <validatorOptions>
                }
            }
        }
    });
     
      
       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
       56
       57
       58
       59
       60
       61
       62
       63
       64
       65
       66
       67
       68
       69
       70
       71
       72
       73
       74
       75
       76
       77
       78
       79
       80
       81
       82
       83
       84
       85
       86
       87
       88
       89
       90
       91
       92
       93
       94
       95
       96
       97
       98
       99
       100
       101
       102
       103
       104
       105
       106
       107
       108
       109
       110
       111
       112
       113
       114
       115
       116
       117
      
     
      
       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
       56
       57
       58
       59
       60
       61
       62
       63
       64
       65
       66
       67
       68
       69
       70
       71
       72
       73
       74
       75
       76
       77
       78
       79
       80
       81
       82
       83
       84
       85
       86
       87
       88
       89
       90
       91
       92
       93
       94
       95
       96
       97
       98
       99
       100
       101
       102
       103
       104
       105
       106
       107
       108
       109
       110
       111
       112
       113
       114
       115
       116
       117

## 四、定义自定义验证规则 ##

该规则是拓展插件的validators方法。   
我将项目中常用的方法放到了一个单独js中，也就是上面第一步引用的自定义方法。

使用方法如下：

## 五、常用事件 ##

1、重置某一单一验证字段验证规则

$(formName).data(“bootstrapValidator”).updateStatus("fieldName",  "NOT_VALIDATED",  null );
     
      
       1
      
     
      
       1

2、重置表单所有验证规则

$(formName).data("bootstrapValidator").resetForm();
     
      
       1
      
     
      
       1

3、手动触发表单验证

//触发全部验证
    $(formName).data(“bootstrapValidator”).validate();
    //触发指定字段的验证
    $(formName).data(“bootstrapValidator”).validate('fieldName');
     
      
       1
       2
       3
       4
      
     
      
       1
       2
       3
       4

4、获取当前表单验证状态

// flag = true/false 
    var flag = $(formName).data(“bootstrapValidator”).isValid();
     
      
       1
       2
      
     
      
       1
       2

5、根据指定字段名称获取验证对象

// element = jq对象 / null
    var element = $(formName).data(“bootstrapValidator”).getFieldElements('fieldName');
     
      
       1
       2
      
     
      
       1
       2

## 六、表单提交 ##

1、当提交按钮是普通按钮   
手动触发表单验证   
示例：

$("buttonName").on("click", function(){ 
         //获取表单对象
        var bootstrapValidator = form.data('bootstrapValidator');
            //手动触发验证
            bootstrapValidator.validate();
            if(bootstrapValidator.isValid()){
                //表单提交的方法、比如ajax提交
            }
    });
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
      
     
      
       1
       2
       3
       4
       5
       6
       7
       8
       9

2、当提交按钮的\[type=”submit”\]时   
会在success之前自动触发表单验证

var bootstrapValidator = form.data('bootstrapValidator');
    bootstrapValidator.on('success.form.bv', function (e) { 
        e.preventDefault();
        //提交逻辑
    });

[https_github.com_nghuuphuoc_bootstrapvalidator_archive_v0.4.5.zip]: https://github.com/nghuuphuoc/bootstrapvalidator/archive/v0.4.5.zip