bootstrapvalidator之API学习教程
发布时间 - 2026-01-11 02:07:13 点击率:次最近项目用到了bootstrap框架,其中前端用的校验,采用的是bootstrapvalidator插件,也是非常强大的一款插件。我这里用的是0.5.2版本。

下面记录一下使用中学习到的相关API,不定期更新。
1. 获取validator对象或实例
一般使用校验是直接调用$(form).bootstrapValidator(options)来初始化validator。初始化后有两种方式获取validator对象或实例,可以用来调用其对象的方法,比如调用resetForm来重置表单。有两种方式获取:
1)
// Get plugin instance
var bootstrapValidator = $(form).data('bootstrapValidator');
// and then call method
bootstrapValidator.methodName(parameters)
这种方式获取的是BootstrapValidator的实例,可以直接调用其方法。
2)
$(form).bootstrapValidator(methodName, parameters);
这种方式获取的是代表当前form的jquery对象,调用方式是将方法名和参数分别传入到bootstrapValidator方法中,可以链式调用。
两种方式的使用分别如下:
// The first way
$(form)
.data('bootstrapValidator')
.updateStatus('birthday', 'NOT_VALIDATED')
.validateField('birthday');
// The second one
$(form)
.bootstrapValidator('updateStatus', 'birthday', 'NOT_VALIDATED')
.bootstrapValidator('validateField', 'birthday');
2. defaultSubmit()
使用默认的提交方式提交表单,调用此方法BootstrapValidator将不执行任何的校验。一般需要时可以放在validator校验的submitHandler属性里调用。
使用:
$('#defaultForm').bootstrapValidator({
fields: {
username: {
message: 'The username is not valid',
validators: {
notEmpty: {
message: 'The username is required and can\'t be empty'
}
}
}
},
submitHandler: function(validator, form, submitButton) {
// a)
// Use Ajax to submit form data
//$.post(form.attr('action'), form.serialize(), function(result) {
// ... process the result ...
//}, 'json');
//b)
// Do your task
// ...
// Submit the form
validator.defaultSubmit();
}
});
3. disableSubmitButtons(boolean)
启用或禁用提交按钮。BootstrapValidator里默认的提交按钮是所有表单内的type属性值为submit的按钮,即[type="submit"]。
使用:
当登录失败时,重新启用提交按钮。
$('#loginForm').bootstrapValidator({
message: 'This value is not valid',
feedbackIcons: {
valid: 'glyphicon glyphicon-ok',
invalid: 'glyphicon glyphicon-remove',
validating: 'glyphicon glyphicon-refresh'
},
submitHandler: function(validator, form, submitButton) {
$.post(form.attr('action'), form.serialize(), function(result) {
// The result is a JSON formatted by your back-end
// I assume the format is as following:
// {
// valid: true, // false if the account is not found
// username: 'Username', // null if the account is not found
// }
if (result.valid == true || result.valid == 'true') {
// You can reload the current location
window.location.reload();
// Or use Javascript to update your page, such as showing the account name
// $('#welcome').html('Hello ' + result.username);
} else {
// The account is not found
// Show the errors
$('#errors').html('The account is not found').removeClass('hide');
// Enable the submit buttons
$('#loginForm').bootstrapValidator('disableSubmitButtons', false);
}
}, 'json');
},
fields: {
username: {
validators: {
notEmpty: {
message: 'The username is required'
}
}
},
password: {
validators: {
notEmpty: {
message: 'The password is required'
}
}
}
}
});
4. enableFieldValidators(field, enabled)
启用或禁用指定字段的所有校验。这里我的实
验结果是如果禁用了校验,好像对应的字段输入(文本框、下拉等)也会变为禁用。
使用:
当密码框不为空时,开启密码框和确认密码框的校验:
// Enable the password/confirm password validators if the password is not empty
$('#signupForm').find('[name="password"]').on('keyup', function() {
var isEmpty = $(this).val() == '';
$('#signupForm').bootstrapValidator('enableFieldValidators', 'password', !isEmpty)
.bootstrapValidator('enableFieldValidators', 'confirm_password', !isEmpty);
if ($(this).val().length == 1) {
$('#signupForm').bootstrapValidator('validateField', 'password')
.bootstrapValidator('validateField', 'confirm_password');
}
});
5. getFieldElements(field)根据指定的name获取指定的元素,返回值是null或一个jQuery对象数组。
6. isValid()返回当前需要验证的所有字段是否都合法。调用此方法前需先调用validate来进行验证,validate方法可用在需要点击按钮或者链接而非提交对表单进行校验的时候。使用:点击某按钮时,提示所有字段是否通过校验。
$("#isAllValid").on("click", function(){
alert($("#defaultForm").data('bootstrapValidator').isValid());
});
7. resetForm(Boolean)
重置表单中设置过校验的内容,将隐藏所有错误提示和图标。
使用:
$("#isAllValid").on("click", function(){
alert($("#defaultForm").data('bootstrapValidator').isValid());
if(!$("#defaultForm").data('bootstrapValidator').isValid()) {
$("#defaultForm").data('bootstrapValidator').resetForm();
}
});
8. updateElementStatus($field, status, validatorName)
更新元素状态。status的值有:NOT_VALIDATED, VALIDATING, INVALID or VALID。
9. updateStatus(field, status, validatorName)
更新指定的字段状态。BootstrapValidator默认在校验某个字段合法后不再重新校验,当调用其他插件或者方法可能会改变字段值时,需要重新对该字段进行校验。
使用:
点击按钮对文本框进行赋值,并对其重新校验:
$('#defaultForm').bootstrapValidator({
fields: {
username: {
message: 'The username is not valid',
validators: {
notEmpty: {
message: 'The username is required and can\'t be empty'
}
}
},
stringLength: {
min: 6,
max: 30,
message: 'The username must be more than 6 and less than 30 characters long'
}
}
});
$("#setname").on("click", function(){
$("input[name=username]").val('san');
var bootstrapValidator = $("#defaultForm").data('bootstrapValidator');
bootstrapValidator.updateStatus('username', 'NOT_VALIDATED').validateField('username');
//错误提示信息变了
});
10. validate()
手动对表单进行校验,validate方法可用在需要点击按钮或者链接而非提交对表单进行校验的时候。
由第一条可知,调用方式同样有两种:
$(form).bootstrapValidator(options).bootstrapValidator('validate');
// or
$(form).bootstrapValidator(options);
$(form).data('bootstrapValidator').validate();
11. validateField(field)
对指定的字段进行校验。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
# bootstrapvalidator
# API
# JS组件Form表单验证神器BootstrapValidator
# 基于jQuery 实现bootstrapValidator下的全局验证
# 实用又漂亮的BootstrapValidator表单验证插件
# BootstrapValidator超详细教程(推荐)
# Bootstrap中的表单验证插件bootstrapValidator使用方法整理(推荐)
# jquery插件bootstrapValidator数据验证详解
# Bootstrapvalidator校验、校验清除重置的实现代码(推荐)
# jquery插件bootstrapValidator表单验证详解
# BootstrapValidator不触发校验的实现代码
# bootstrapValidator bootstrap-select验证不可用的解决办法
# 表单
# 的是
# 有两种
# 链式
# 而非
# 用在
# 文本框
# 直接调用
# 放在
# 也会
# 两种
# 我这
# 提示信息
# 对其
# 第一条
# 将不
# 值为
# 大家多多
# 为空
# 可以用来
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
悟空识字怎么关闭自动续费_悟空识字取消会员自动扣费步骤
JavaScript如何实现路由_前端路由原理是什么
Laravel用户密码怎么加密_Laravel Hash门面使用教程
高端云建站费用究竟需要多少预算?
如何快速生成可下载的建站源码工具?
图片制作网站免费软件,有没有免费的网站或软件可以将图片批量转为A4大小的pdf?
Win11怎么更改系统语言为中文_Windows11安装语言包并设为显示语言
jquery插件bootstrapValidator表单验证详解
如何在腾讯云服务器快速搭建个人网站?
深圳防火门网站制作公司,深圳中天明防火门怎么编码?
详解Huffman编码算法之Java实现
JavaScript实现Fly Bird小游戏
iOS正则表达式验证手机号、邮箱、身份证号等
Laravel如何实现模型的全局作用域?(Global Scope示例)
Laravel数据库迁移怎么用_Laravel Migration管理数据库结构的正确姿势
Laravel如何实现全文搜索_Laravel Scout集成Algolia或Meilisearch教程
Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全
Java Adapter 适配器模式(类适配器,对象适配器)优缺点对比
大同网页,大同瑞慈医院官网?
如何破解联通资金短缺导致的基站建设难题?
C++用Dijkstra(迪杰斯特拉)算法求最短路径
怎么用AI帮你设计一套个性化的手机App图标?
网站页面设计需要考虑到这些问题
详解jQuery中基本的动画方法
海南网站制作公司有哪些,海口网是哪家的?
nodejs redis 发布订阅机制封装实现方法及实例代码
Laravel Blade组件怎么用_Laravel可复用视图组件的创建与使用
手机软键盘弹出时影响布局的解决方法
百度输入法全感官ai怎么关 百度输入法全感官皮肤关闭
网站设计制作书签怎么做,怎样将网页添加到书签/主页书签/桌面?
Android Socket接口实现即时通讯实例代码
Laravel怎么进行数据库事务处理_Laravel DB Facade事务操作确保数据一致性
JS中页面与页面之间超链接跳转中文乱码问题的解决办法
linux写shell需要注意的问题(必看)
Laravel如何与Pusher实现实时通信?(WebSocket示例)
php8.4header发送头信息失败怎么办_php8.4header函数问题解决【解答】
佛山网站制作系统,佛山企业变更地址网上办理步骤?
Laravel如何使用Eloquent进行子查询
b2c电商网站制作流程,b2c水平综合的电商平台?
简历在线制作网站免费版,如何创建个人简历?
开心动漫网站制作软件下载,十分开心动画为何停播?
教你用AI将一段旋律扩展成一首完整的曲子
Laravel如何生成API文档?(Swagger/OpenAPI教程)
Laravel如何构建RESTful API_Laravel标准化API接口开发指南
如何用虚拟主机快速搭建网站?详细步骤解析
zabbix利用python脚本发送报警邮件的方法
Laravel如何发送系统通知_Laravel Notifications实现多渠道消息通知
Laravel模型事件有哪些_Laravel Model Event生命周期详解
谷歌浏览器如何更改浏览器主题 Google Chrome主题设置教程
Laravel如何生成PDF或Excel文件_Laravel文档导出工具与使用教程

