JS组件系列——Form表单验证神器： BootstrapValidator

淡淡的烟草味﹌ 2022-07-13 02:51 209阅读 0赞

前言：做Web开发的我们，表单验证是再常见不过的需求了。友好的错误提示能增加用户体验。博主搜索bootstrap表单验证，搜到的结果大部分都是文中的主题：bootstrapvalidator。今天就来看看它如何使用吧。

## 一、源码及API地址 ##

介绍它之前，还是给出它的源码以及API的地址吧。

bootstrapvalidator源码：[https://github.com/nghuuphuoc/bootstrapvalidator][https_github.com_nghuuphuoc_bootstrapvalidator]

boostrapvalidator api：[http://bv.doc.javake.cn/api/][http_bv.doc.javake.cn_api]

## 二、代码以及效果展示 ##

### 1、初级用法 ###

来看bootstrapvalidator的描述：A jQuery form validator for Bootstrap 3。从描述中我们就可以知道它至少需要jQuery、bootstrap的支持。我们首先引入需要的js组件

我们知道，既然是表单验证，那么我们在cshtml页面就必须要有一个Form，并且我们知道Form里面取元素都是通过name属性去取值的，所以，表单里面的元素都要有一个name的属性值。

![复制代码][copycode.gif]

<form>
                <div class="form-group">
                    <label>Username</label>
                    <input type="text" class="form-control" name="username" />
                </div>
                <div class="form-group">
                    <label>Email address</label>
                    <input type="text" class="form-control" name="email" />
                </div>
                <div class="form-group">
                    <button type="submit" name="submit" class="btn btn-primary">Submit</button>
                </div>
            </form>

![复制代码][copycode.gif]

有了表单元素之后，就是我们的js初始化了。

![复制代码][copycode.gif]

$(function () {
            $('form').bootstrapValidator({

message: 'This value is not valid',
                　feedbackIcons: {
       
                    　　　　　　　　valid: 'glyphicon glyphicon-ok',
                    　　　　　　　　invalid: 'glyphicon glyphicon-remove',
                    　　　　　　　　validating: 'glyphicon glyphicon-refresh'
                　　　　　　　　   },

fields: {
                    username: {
                        message: '用户名验证失败',
                        validators: {
                            notEmpty: {
                                message: '用户名不能为空'
                            }
                        }
                    },
                    email: {
                        validators: {
                            notEmpty: {
                                message: '邮箱地址不能为空'
                            }
                        }
                    }
                }
            });
        });

![复制代码][copycode.gif]

内容应该很容易看懂。来看效果：

验证通不过，提交按钮灰掉不能点击

![459756-20151210144808574-904160004.png][]

验证通过，提交按钮恢复

![459756-20151210144816871-1939421160.png][]

看看效果先感受下，最大优点：使用简单，界面友好。下面我们来看看重叠验证。

### 2、中级用法 ###

上面我们知道了非空验证的写法，除此之外肯定还有其他验证方式啊。别急，我们慢慢来看。上面的代码cshtml部分不动，js部分我们稍作修改：

![复制代码][copycode.gif]

$(function () {
            $('form').bootstrapValidator({
                message: 'This value is not valid',
                feedbackIcons: {
                    valid: 'glyphicon glyphicon-ok',
                    invalid: 'glyphicon glyphicon-remove',
                    validating: 'glyphicon glyphicon-refresh'
                },
                fields: {
                    username: {
                        message: '用户名验证失败',
                        validators: {
                            notEmpty: {
                                message: '用户名不能为空'
                            },
                            stringLength: {
                                min: 6,
                                max: 18,
                                message: '用户名长度必须在6到18位之间'
                            },
                            regexp: {
                                regexp: /^[a-zA-Z0-9_]+$/,
                                message: '用户名只能包含大写、小写、数字和下划线'
                            }
                        }
                    },
                    email: {
                        validators: {
                            notEmpty: {
                                message: '邮箱不能为空'
                            },
                            emailAddress: {
                                message: '邮箱地址格式有误'
                            }
                        }
                    }
                }
            });
        });

![复制代码][copycode.gif]

加上了重叠验证我们来看效果：

![459756-20151210150414668-529203273.png][]

![459756-20151210150421840-807792716.png][]

![459756-20151210150428574-1369394488.png][]

由上面的代码可以看出在validators属性对应一个Json对象，里面可以包含多个验证的类型：

notEmpty：非空验证；

stringLength：字符串长度验证；

regexp：正则表达式验证；

emailAddress：邮箱地址验证（都不用我们去写邮箱的正则了~~）

除此之外，在文档里面我们看到它总共有46个验证类型，我们抽几个常见的出来看看：

[base64][]：64位编码验证；

[between][]：验证输入值必须在某一个范围值以内，比如大于10小于100；

[creditCard][]：身份证验证；

[date][]：日期验证；

[ip][]：IP地址验证；

[numeric][]：数值验证；

[phone][]：电话号码验证；

[uri][]：url验证；

更多验证类型详见：[http://bv.doc.javake.cn/validators/][http_bv.doc.javake.cn_validators]。当然涉及中文的验证可能会有些小问题，园友们如果有需要可以自行下去用代码测试下。

还有一个比较常用的就是submitHandler属性，它对应着提交按钮的事件方法。使用如下：

![复制代码][copycode.gif]

在它的Demo里面介绍了很多验证的实例。我们简单看看它的效果，至于实现代码，其实很简单，有兴趣的可以直接看api。

颜色验证

![459756-20151210170547215-1868321511.png][]

Tab页表单验证

![459756-20151210170609590-479703139.png][]

按钮验证

![459756-20151210170620558-1320826846.png][]

[https_github.com_nghuuphuoc_bootstrapvalidator]: https://github.com/nghuuphuoc/bootstrapvalidator
[http_bv.doc.javake.cn_api]: http://bv.doc.javake.cn/api/
[copycode.gif]: /images/20220713/67b44e130d2144ed88bd3dfbf6bb1849.png
[459756-20151210144808574-904160004.png]: /images/20220713/892128560818406686b3eb76a9f50ab8.png
[459756-20151210144816871-1939421160.png]: /images/20220713/c8d7de64fcf1423d988c2324e8d79f3c.png
[459756-20151210150414668-529203273.png]: /images/20220713/78e5a713dec5426692a0c66e65886d5b.png
[459756-20151210150421840-807792716.png]: /images/20220713/753459576d284ad59d18745e00d1c6e6.png
[459756-20151210150428574-1369394488.png]: /images/20220713/2f50461e26ec462e9d2b2670203ed6b2.png
[base64]: http://bv.doc.javake.cn/bootstrap-validator/validators/base64/
[between]: http://bv.doc.javake.cn/bootstrap-validator/validators/between/
[creditCard]: http://bv.doc.javake.cn/bootstrap-validator/validators/creditCard/
[date]: http://bv.doc.javake.cn/bootstrap-validator/validators/date/
[ip]: http://bv.doc.javake.cn/bootstrap-validator/validators/ip/
[numeric]: http://bv.doc.javake.cn/bootstrap-validator/validators/numeric/
[phone]: http://bv.doc.javake.cn/bootstrap-validator/validators/phone/
[uri]: http://bv.doc.javake.cn/bootstrap-validator/validators/uri/
[http_bv.doc.javake.cn_validators]: http://bv.doc.javake.cn/validators/
[459756-20151210170547215-1868321511.png]: /images/20220713/98dda2ed762d4bb6bcb2b52bba543453.png
[459756-20151210170609590-479703139.png]: /images/20220713/da5fe0e7496d46d1aed3c7d57d47d324.png
[459756-20151210170620558-1320826846.png]: /images/20220713/85a951ebf8984e46b75d4b0c7cf72b48.png