BootstrapValidator超详细教程（推荐）
⼀、引⼊必要⽂件
<link rel="stylesheet" href="/path/to/bootstrap/css/bootstrap.css"/>
<link rel="stylesheet" href="/path/to/dist/css/bootstrapValidator.min.css"/>
<script type="text/javascript" src="/path/to/jquery/jquery.min.js"></script>
<script type="text/javascript" src="/path/to/bootstrap/js/bootstrap.min.js"></script>
// 带众多常⽤默认验证规则的
<script type="text/javascript" src="/path/to/dist/js/bootstrapValidator-all.js"></script>
// 不带常⽤规则，需⾃定义规则
<script type="text/javascript" src="/path/to/dist/js/bootstrapValidator.min.js"></script>
//此⽅法是我编写常⽤的⾃定义规则的，也可直接写到对应的表单的js中
<script type="text/javascript" src="/path/to/dist/js/validator/atfmCustomValidatorRules.js"></script>
⼆、编写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、添加到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>
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: {
bootstrap 5//多个重复
<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: {
//多个重复
//官⽅默认验证参照 bv.doc.javake/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'}
st( $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”).validate('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');
<('success.form.bv', function (e) {
e.preventDefault();
//提交逻辑
});
以上所述是⼩编给⼤家介绍的BootstrapValidator超详细教程(推荐)，希望对⼤家有所帮助，如果⼤家有任何疑问请给我留⾔，⼩编会及时回复⼤家的。在此也⾮常感谢⼤家对⽹站的⽀持！
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论