全景速访 世间观察 bootstrap.validator.js 怎么用,bootstrap.validator.js 使用教程,从入门到实战

bootstrap.validator.js 怎么用,bootstrap.validator.js 使用教程,从入门到实战

bootstrap.validator.js 使用指南

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

bootstrap.validator.js 怎么用,bootstrap.validator.js 使用教程,从入门到实战

引入文件

<!-- 依赖 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+$/]"

多个规则用逗号连续:

bootstrap.validator.js 怎么用,bootstrap.validator.js 使用教程,从入门到实战

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>

bootstrap.validator.js 怎么用,bootstrap.validator.js 使用教程,从入门到实战

本文来自网络,不代表大媒体立场,转载请注明出处:https://m.520qjsf.com/news-m/8755.html

作者: admin

擅长以细腻笔触描绘现代人情感困境/以独特视角解读科技人文交叉领域
下一篇
http://520qjsf.com/zb_users/upload/2026/11/20261117191613179491417344736.jpg

(风水必背口诀下雨)" 风水必背口诀

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

工作时间:周一至周五,9:00-17:30,节假日休息

微信扫一扫关注我们