表单验证之BootstrapValidator

女爷i 2022-07-14 15:20 259阅读 0赞

Bootstrap Validator是为Bootstrap3设计的一款表单验证jQuery插件，非常适合基于Bootstrap框架的网站。  
看作者的github，这款插件已经不再更新了，而推荐使用FormValidation，不过现在还是先介绍一下BootstrapValidator的使用。

--------------------

## 准备工作 ##

BootstrapValidator文档地址：[http://bv.doc.javake.cn/][http_bv.doc.javake.cn]

下载源码后，将其中的`bootstrapValidator.min.css`和`bootstapValidator.min.js`导入项目，并在页面中引入这些组件，如下：

其中path是对应文件导入项目的路径

## 简单应用 ##

文档中给出调用插件的方法是：

$(document).ready(function() { 
        $(formSelector).bootstrapValidator({
            excluded: ...,
            feedbackIcons: ...,
            live: 'enabled',
            message: 'This value is not valid',
            submitButtons: 'button[type="submit"]',
            submitHandler: null,
            trigger: null,
            fields: {
                <fieldName>: { enabled: true, message: 'This value is not valid', container: null, selector: null, trigger: null, // Map the validator name with its options validators: { ... <validatorName>: <validatorOptions> ... } } ... } }); });

下面针对一个简单的表单来进行说明：

对于上面这个表单应用BootstrapValidator非常简单，**fieldName** 对应表单中每一项的 **name** 属性，然后BV还内置了很多 **validator** 供用户选择，详细可参考文档的 **[validators][]** 部分，可以看到，邮箱格式的验证正是其中之一，不需要用户自己写正则了。

$(document).ready(function() { 
        $('#signup-form').bootstrapValidator({
            fields: {
                username: {
                    validators: {
                        notEmpty: {
                           message: '用户名不能为空'
                        },
                        stringLength: {
                           min: 3,
                           max: 6,
                           message: '用户名只能在3-6个字符之间哦~'
                        }
                    }
                },
                email: {
                    validators: {
                        emailAddress: {
                            message: '邮箱格式有误'
                        }
                    }
                },
                password: {
                    validators: {
                        notEmpty: {
                            message: '密码不能为空'
                        },
                        stringLength: {
                            min: 6,
                            max: 8,
                            message: '密码必须在6-8个字符之间~'
                        },
                        regexp: {
                            regexp: /^[a-zA-Z0-9]+$/,
                            message: '密码只能由字母、数字组成~'
                        }
                    }
                }
            }
        });
    });

不符合验证要求时，会显示错误提示的message，并且禁用提交按钮，提示信息的颜色字体等等都可以重写css来设置，效果展示如下：

![注册验证][SouthEast]

注：图中的注册按钮处于禁用状态

下面再介绍一下fields的 **selector**，因为表单数据往往是属于某一个注册用户所有，为方便与后台进行数据交互，我们往往按如下的形式设置name，这时候就不能直接利用name属性来进行验证了，而是使用selector来定义fields：

对应的js代码：

$(document).ready(function() { 
        $('#signup-form').bootstrapValidator({
            fields: {
                user: {
                    selector: '#user',  
                    validators: {
                        notEmpty: {
                           message: '用户名不能为空'
                        },
                        stringLength: {
                           min: 3,
                           max: 6,
                           message: '用户名只能在3-6个字符之间哦~'
                        }
                    }
                },
                pass: {
                    selector: '#pass',
                    validators: {
                        notEmpty: {
                            message: '密码不能为空'
                        },
                        stringLength: {
                            min: 6,
                            max: 8,
                            message: '密码必须在6-8个字符之间~'
                        },
                        regexp: {
                            regexp: /^[a-zA-Z0-9]+$/,
                            message: '密码只能由字母、数字组成~'
                        }
                    }
                }
            }
        });
    });

如果你嫌弃这样写代码累赘，可以直接应用相应的HTML属性，详细可参考文档的 **[settings][]** 部分

![截图2][2]

--------------------

以上只是BootstrapValidator的一个非常简单的应用， [官方文档][http_bv.doc.javake.cn] 很详细，感兴趣的话就继续查阅，来深入了解它的强大功能吧~

[http_bv.doc.javake.cn]: http://bv.doc.javake.cn/
[validators]: http://bv.doc.javake.cn/validators/
[SouthEast]: /images/20220714/6e67d616759d477fa4753849643dccbd.png
[settings]: http://bv.doc.javake.cn/settings/
[2]: /images/20220714/664a6d58960544b4a9f30e0b1196e803.png