bootstrap.validator.js 使用指南
bootstrap.validator.js 是一个基于 Bootstrap 的表单验证插件,常用于 WeCenter/Anwsion 等基于 Bootstrap 的 PHP 项目中,以下是完整使用说明。

引入文件
<!-- 依赖 Bootstrap 和 jQuery --> <link rel="stylesheet" href="bootstrap.min.css"> <script src="jquery.min.js"></script> <script src="bootstrap.min.js"></script> <!-- 引入验证插件 --> <link rel="stylesheet" href="bootstrap.validator.css"> <script src="bootstrap.validator.js"></script>
说明:有些版本是
jquery.validator.js+bootstrap.validator.js,注意依赖关系。
基本用法
HTML 结构
<form id="loginForm" class="form-horizontal">
<div class="form-group">
<label class="col-sm-3 control-label">用户名</label>
<div class="col-sm-9">
<input type="text" name="username" class="form-control"
data-validate="required,length[3,20]"
placeholder="请输入用户名">
</div>
</div>
<div class="form-group">
<label class="col-sm-3 control-label">邮箱</label>
<div class="col-sm-9">
<input type="text" name="email" class="form-control"
data-validate="required,email">
</div>
</div>
<div class="form-group">
<label class="col-sm-3 control-label">密码</label>
<div class="col-sm-9">
<input type="password" name="password" class="form-control"
data-validate="required,length[6,32]">
</div>
</div>
<div class="form-group">
<div class="col-sm-offset-3 col-sm-9">
<button type="submit" class="btn btn-primary">提交</button>
</div>
</div>
</form>
JS 初始化
$(function() {
$('#loginForm').validator({
// 全局配置
timely: 2, // 实时验证:1-失去焦点, 2-输入时, 3-两者
theme: 'default', // 提示主题
stopOnError: true, // 有错误时阻止提交
rules: {
// 自定义规则
myrule: function(el, param, value) {
if (value !== 'admin') {
return '必须是 admin';
}
}
},
// 提交处理
valid: function(form) {
// 验证通过后执行
$.ajax({
url: '/api/login',
type: 'POST',
data: $(form).serialize(),
success: function(res) {
if (res.success) {
location.href = '/';
} else {
alert(res.message);
}
}
});
},
invalid: function(form) {
console.log('验证失败');
}
});
});
常用内置规则
| 规则 | 说明 | 示例 |
|---|---|---|
required |
必填 | data-validate="required" |
email |
邮箱格式 | data-validate="email" |
url |
URL 格式 | data-validate="url" |
number |
数字 | data-validate="number" |
int |
整数 | data-validate="int" |
date |
日期 | data-validate="date" |
mobile |
手机号 | data-validate="mobile" |
idcard |
身份证 | data-validate="idcard" |
length[a,b] |
长度范围 | data-validate="length[3,20]" |
minlength[n] |
最小长度 | data-validate="minlength[6]" |
maxlength[n] |
最大长度 | data-validate="maxlength[20]" |
min[n] |
最小值 | data-validate="min[1]" |
max[n] |
最大值 | data-validate="max[100]" |
filter['xxx'] |
等于指定值 | data-validate="filter['abc']" |
match[name] |
与另一字段一致 | data-validate="match[password]" |
regexp[规则] |
正则 | data-validate="regexp[/^\\d+$/]" |
多个规则用逗号连续:

data-validate="required,length[3,20],number"
自定义规则
$('#myForm').validator({
rules: {
// 简单规则
noSpace: function(el, param, value) {
if (/\s/.test(value)) {
return '不能包含空格';
}
},
// 带参数规则
range: function(el, param, value) {
var p = param.split(',');
var n = parseFloat(value);
if (n < p[0] || n > p[1]) {
return '数值必须在 ' + p[0] + ' 到 ' + p[1] + ' 之间';
}
}
}
});
使用:
<input data-validate="noSpace"> <input data-validate="range[10,100]">
字段级配置(data-* 属性)
<input type="text"
name="username"
data-validate="required,length[3,20]"
data-validate-msg="用户名必填"
data-timely="1"
data-msg-required="请输入用户名"
data-msg-length="长度3-20位">
data-msg-规则名="自定义提示"可以单独定制提示data-timely单独控制实时验证时机
编程接口
var v = $('#myForm').validator(); // 返回实例
// 手动触发验证
v.isValid(); // 验证所有字段,返回布尔值
// 验证单个字段
$('#myForm').validator('check', 'username');
// 重置表单
$('#myForm').validator('reset');
// 销毁验证
$('#myForm').validator('destroy');
提交方式二选一
使用 valid 回调(推荐)
$('#myForm').validator({
valid: function(form) {
// 这里提交,常用于 Ajax
}
});
正常 submit
<form action="/submit" method="post" id="myForm">
配合:
$('#myForm').validator({
stopOnError: true // 有错误阻止提交
});
常见问题
Q1: 插件没生效?
- 检查 jQuery 是否已加载(在其后面引入)
- 检查选择器是否正确(
.validator()调用在 DOM 就绪后) - 检查表单元素的
name属性是否存在
Q2: 提示不显示?
- 检查
bootstrap.validator.css是否引入 - 检查是否被其他样式覆盖
Q3: Ajax 提交出错怎么办?
有时如果使用 type="submit",会触发表单原生提交,建议用 <button type="button"> + 手动绑定 click,或者使用 valid 回调并在回调用 return false 阻止默认提交。
Q4: 与 jquery.validate.js 冲突?
两者是不同插件,不要同时引入,若需选择,jquery.validate 通用性更强,bootstrap.validator 与 Bootstrap 样式集成更好。
完整示例
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">验证示例</title>
<link rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.css">
<link rel="stylesheet" href="bootstrap.validator.css">
</head>
<body>
<div class="container" style="margin-top:40px;">
<form id="regForm" class="form-horizontal">
<div class="form-group">
<label class="col-sm-2 control-label">用户名</label>
<div class="col-sm-6">
<input type="text" name="username" class="form-control"
data-validate="required,length[3,20]">
</div>
</div>
<div class="form-group">
<label class="col-sm-2 control-label">邮箱</label>
<div class="col-sm-6">
<input type="text" name="email" class="form-control"
data-validate="required,email">
</div>
</div>
<div class="form-group">
<label class="col-sm-2 control-label">密码</label>
<div class="col-sm-6">
<input type="password" name="password" class="form-control"
data-validate="required,minlength[6]">
</div>
</div>
<div class="form-group">
<label class="col-sm-2 control-label">确认密码</label>
<div class="col-sm-6">
<input type="password" name="password2" class="form-control"
data-validate="required,match[password]">
</div>
</div>
<div class="form-group">
<div class="col-sm-offset-2 col-sm-6">
<button type="submit" class="btn btn-success">注册</button>
</div>
</div>
</form>
</div>
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.js"></script>
<script src="bootstrap.validator.js"></script>
<script>
$(function() {
$('#regForm').validator({
timely: 2,
stopOnError: true,
valid: function(form) {
alert('验证通过,开始提交');
// $.ajax({...});
},
invalid: function(form) {
console.log('存在错误');
}
});
});
</script>
</body>
</html>

