BootstrapValidator超详细教程(推荐)

一、引入必要文件

下载地址：(https://github.com/nghuuphuoc/bootstrapvalidator/archive/v0.4.5.zip)

<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"requireddata-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: {//多个重复<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>}}}});