废话很少说,直接开始~javascript
下载地址:(https://github.com/nghuuphuoc/bootstrapvalidator/archive/v0.4.5.zip)css
<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>
在表单中,若对某一字段想添加验证规则,默认须要以<div class=”form-group”></div>
包裹(对应错误提示会根据该class值定位),内部<input class="form-control" />
标签必须有name属性值,此值为验证匹配字段。html
注:该值不是绝对的,也能够经过js手动指定错误提示位置和验证的输入框(后续会讲解到)。java
<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>
一、添加到HTML上jquery
<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>
二、添加到js上git
注:如下参数上面的赋值都为默认值,不添加该参数即便用默认值github
$(formSelector).bootstrapValidator({
/** * 指定不验证的状况 * 值可设置为如下三种类型: * 一、String ':disabled, :hidden, :not(:visible)' * 二、Array 默认值 [':disabled', ':hidden', ':not(:visible)'] * 三、带回调函数 [':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中,也就是上面第一步引用的自定义方法。web
使用方法以下:ajax
(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));
一、重置某一单一验证字段验证规则json
$(formName).data(“bootstrapValidator”).updateStatus("fieldName", "NOT_VALIDATED", null );
二、重置表单全部验证规则
$(formName).data("bootstrapValidator").resetForm();
三、手动触发表单验证
//触发所有验证
$(formName).data(“bootstrapValidator”).validate();
//触发指定字段的验证
$(formName).data(“bootstrapValidator”).validateField('fieldName');
四、获取当前表单验证状态
// flag = true/false
var flag = $(formName).data(“bootstrapValidator”).isValid();
五、根据指定字段名称获取验证对象
// element = jq对象 / null
var element = $(formName).data(“bootstrapValidator”).getFieldElements('fieldName');
一、当提交按钮是普通按钮
手动触发表单验证
示例:
$("buttonName").on("click", function(){
//获取表单对象
var bootstrapValidator = form.data('bootstrapValidator');
//手动触发验证
bootstrapValidator.validate();
if(bootstrapValidator.isValid()){
//表单提交的方法、好比ajax提交
}
});
二、当提交按钮的[type=”submit”]时
会在success以前自动触发表单验证
var bootstrapValidator = form.data('bootstrapValidator');
bootstrapValidator.on('success.form.bv', function (e) {
e.preventDefault();
//提交逻辑
});
不知道各位小伙伴们看懂了没,这个插件蛮好用的,上手也快,结合bootstrap风格节省了不少样式调节时间。 本文纯我的实战总结,有不足之处还望各位高人留言指点~