BootstrapValidator超详细教程(推荐)
一、引入必要文件
下载地址:()
rush:js;">
dist/css/bootstrapValidator.min.css"/>
// 带众多常用
默认验证规则的
// 不带常用规则,需
自定义规则
//此
方法是我编写常用的
自定义规则的,也可直接写到对应的表单的js中
二、编写HTML
在表单中,若对某一字段想添加验证规则,默认需要以
包裹(对应
错误提示会根据该class值定位),内部
标签必须有name
属性值,此值为验证匹配字段。
注:该值不是绝对的,也可以通过js手动指定错误提示位置和验证的输入框(后续会讲解到)。
三、添加验证规则
1、添加到HTML上
2、添加到js上
注:以下参数上面的赋值都为默认值,不添加该参数即使用默认值
= 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,submitButton) {
// 实用ajax提交表单
$.post(form.attr('action'),form.serialize(),function(result) {
// .
自定义回调逻辑
},'json');
}
*
*/
submitHandler: null,/**
* 为每个字段设置统一触发验证方式(也可在fields中为每个字段单独定义),
默认是live配置的方式,数据改变就改变
* 也可以指定
一个或多个(多个空格隔开) 'focus blur keyup'
*/
trigger: null,/**
* Number类型 为每个字段设置统一的开始验证情况,当输入字符大于等于设置的数值后才实时触发验证
*/
threshold: null,/**
* 表单域配置
*/
fields: {
//多个重复
: {
//隐藏或显示 该字段的验证
enabled: true,//错误提示信息
message: 'This value is not valid',/**
* 定义错误提示位置 值为CSS选择器设置方式
* 例如:'#firstNameMeg' '.lastNameMeg' '[data-stripe="exp-month"]'
*/
container: null,/**
* 定义验证的节点,CSS选择器设置方式,可不必须是name值。
* 若是id,class,name属性,为该属性值
* 若是其他属性值且有中划线链接,转换为驼峰格式 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没有提供常用验证规则,需自定义验证规则哦
:
}
}
}
});
四、定义自定义验证规则
该规则是拓展插件的validators方法。
我将项目中常用的方法放到了一个单独js中,也就是上面第一步引用的自定义方法。
使用方法如下:
rush:js;">
(function($) {
//
自定义表单验证规则
$.fn.bootstrapValidator.validators = {
: {
/**
* @param {BootstrapValidator} 表单验证实例对象
* @param {jQuery} $field jQuery 对象
* @param {Object} 表单验证配置项值
* @returns {boolean}
*/
validate: function(validator,$field,options) {
// 表单输入的值
// var value = $field.val();
//options为对象,直接.获取需要的值
// 返回true/false
//也可返回{ valid : true/false,message: 'XXXX'}
return reg.test( $field.val() );
}
},};
}(window.jQuery));
五、常用事件
1、重置某一单一验证字段验证规则
rush:js;">
$(formName).data(“bootstrapValidator”).updateStatus("fieldName","NOT_VALIDATED",null );
2、重置表单所有验证规则
rush:js;">
$(formName).data("bootstrapValidator").resetForm();
3、手动触发表单验证
rush:js;">
//触发全部验证
$(formName).data(“bootstrapValidator”).validate();
//触发指定字段的验证
$(formName).data(“bootstrapValidator”).validate('fieldName');
4、获取当前表单验证状态
rush:js;">
// flag = true/false
var flag = $(formName).data(“bootstrapValidator”).isValid();
5、根据指定字段名称获取验证对象
rush:js;">
// element = jq对象 / null
var element = $(formName).data(“bootstrapValidator”).getFieldElements('fieldName');
六、表单提交
1、当提交按钮是普通按钮
手动触发表单验证
示例:
rush:js;">
$("buttonName").on("click",function(){
//
获取表单对象
var bootstrapValidator = form.data('bootstrapValidator');
//手动触发验证
bootstrapValidator.validate();
if(bootstrapValidator.isValid()){
//表单提交的
方法、比如ajax提交
}
});
2、当提交按钮的[type=”submit”]时
会在success之前自动触发表单验证
rush:js;">
var bootstrapValidator = form.data('bootstrapValidator');
bootstrapValidator.on('success.form.bv',function (e) {
e.preventDefault();
//提交逻辑
});
以上所述是小编给大家介绍的BootstrapValidator超详细教程(推荐)。编程之家 jb51.cc 收集整理的教程希望能对你有所帮助,如果觉得编程之家不错,可分享给好友!感谢支持。