bootstrapValidator验证大全

    <meta name='viewport' content='width=device-width, initial-scale=1'>");
out.println("<link href='" + path + "bootstrap3/css/bootstrap.min.css' rel='stylesheet' type='text/css'/>");
out.println("<link href='" + path + "bootstrap3/css/bootstrap-theme.min.css' rel='stylesheet' type='text/css'/>");
out.println("<link href='" + path + "bootstrap3/css/bootstrapValidator.min.css' rel='stylesheet' type='text/css'/>");
out.println("<script type='text/javascript' src='" + path + "bootstrap3/js/jquery.min.js'></script>");
out.println("<script type='text/javascript' src='" + path + "bootstrap3/js/bootstrap.min.js'></script>");
out.println("<script type='text/javascript' src='" + path + "bootstrap3/js/bootstrapValidator.min.js'></script>");


<jsp:include page="../../bootstrap3/bootstrap.jsp"></jsp:include> <script rel="stylesheet"> $(function () { $('form').bootstrapValidator({ live: 'enabled',//验证时机,enabled是内容有变化就验证(默认),disabled和submitted是提交再验证 excluded: [':disabled', ':hidden', ':not(:visible)'],//排除无需验证的控件,比如被禁用的或者被隐藏的 // submitButtons: '#subtn',//指定提交按钮,如果验证失败则变成disabled,但我没试成功,反而加了这句话非submit按钮也会提交到action指定页面 message: '通用的验证失败消息',//特殊处理会用到 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: '账号只能包含大写、小写、数字和下划线' } } }, phone: { message: '电话无效', validators: { notEmpty: { message: '手机号码不能为空' }, stringLength: { min: 11, max: 11, message: '请输入11位手机号码' }, regexp: { regexp: /^1[3|5|7|8]{1}[0-9]{9}$/, message: '请输入正确的手机号码' } } }, verificationCode: { validators: { notEmpty: { message: '验证码不能为空' } } }, password: { message: '密码无效', validators: { notEmpty: { message: '密码不能为空' }, stringLength: { min: 6, max: 18, message: '长度必须在6到30之间' }, identical: {//相同 field: 'repassword', //需要进行比较的input name值 message: '两次密码不一致' }, different: {//不能和用户名相同 field: 'username',//需要进行比较的input name值 message: '不能和用户名相同' }, regexp: { regexp: /^[a-zA-Z0-9_\.]+$/, message: '用户名只能由字母、数字、点和下划线组成' } } }, repassword: { message: '密码无效', validators: { notEmpty: { message: '密码不能为空' }, stringLength: { min: 6, max: 30, message: '长度必须在6到30之间' }, identical: {//相同 field: 'password', message: '两次密码不一致' }, different: {//不能和用户名相同 field: 'username', message: '不能和用户名相同' }, regexp: {//匹配规则 regexp: /^[a-zA-Z0-9_\.]+$/, message: '用户名只能由字母、数字、点和下划线组成' } } }, nickname: { validators: { notEmpty: { message: '昵称不能为空' } } }, email: { validators: { notEmpty: { message: '邮箱地址不能为空' }, emailAddress: { message: '请输入正确的邮件地址' } } }, fields: { datetimeStart: { trigger: "change", validators: { notEmpty: { message: '请选择开始时间' } } }, datetimeEnd: {//日期验证 trigger: "change", validators: { notEmpty: { message: '请选择结束时间' }, callback: { message: '开始时间必须小于结束时间', callback: function (value, validator, $field) { let other = validator.getFieldElements('datetimeStart').val();//获得另一个的值 let start = new Date(other.replace("-", "/").replace("-", "/")); let end = new Date(value.replace("-", "/").replace("-", "/")); if (start <= end) { return true; } return false; } } } }, } } }); }).on('success.form.bv', function (e) { // 防止表单提交 e.preventDefault(); // 获取表单实例 var $form = $(e.target); // 获取BooTrasPalpDealver实例 var bv = $form.data('bootstrapValidator'); // 使用AJAX提交表单数据 $.post('/toback', function (data) { if (data.Status == "ok") { window.location.href = "/toback"; } else if (data.Status == "error") { alert(data.Message); } else { alert("未知错误"); } ; }); }) </script>

 

添加到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>
            }
        }
    }
});

定义自定义验证规则

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

使用方法如下:

(function($) {
    //自定义表单验证规则
    $.fn.bootstrapValidator.validators = {
        <validatorName> : {
            /**
             * @param {BootstrapValidator} 表单验证实例对象
             * @param {jQuery} $field jQuery 对象
             * @param {Object} 表单验证配置项值
             * @returns {boolean}
             */
            validate: function(validator, $field, options) {
                // 表单输入的值
                // var value = $field.val();

                //options为<validatorOptions>对象,直接.获取需要的值

                // 返回true/false
                //也可返回{ valid : true/false, message: 'XXXX'}
                return reg.test( $field.val() );

            }
        },
    };
}(window.jQuery))

 

常用事件

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

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

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

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

3、手动触发表单验证
//触发全部验证
$(formName).data(“bootstrapValidator”).validate();
//触发指定字段的验证
$(formName).data(“bootstrapValidator”).validateField('fieldName');

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

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

 

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

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

 

表单提交

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

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

 

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

var bootstrapValidator = form.data('bootstrapValidator');
bootstrapValidator.on('success.form.bv', function (e) {
    e.preventDefault();
    //提交逻辑
});
posted on 2018-09-04 09:04  博客园197  阅读(1383)  评论(0编辑  收藏  举报