bootstrapValidator 中文API
来源:互联网 发布:android直播软件源码 编辑:程序博客网 时间:2024/06/16 23:29
用法
使用插件初始化表单后$(form).bootstrapValidator(options)
,有两种方法调用插件方法:
// Get plugin instancevar bootstrapValidator = $(form).data('bootstrapValidator');// and then call methodbootstrapValidator.methodName(parameters)
要么:
$(form).bootstrapValidator(methodName, parameters);
第一种方法主要返回BootstrapValidator
实例,同时第二种方法总是返回表示表单的jQuery对象。
所以,可以链接方法如下:
// The first way$(form) .data('bootstrapValidator') .updateStatus('birthday', 'NOT_VALIDATED') .validateField('birthday');// The second one$(form) .bootstrapValidator('updateStatus', 'birthday', 'NOT_VALIDATED') .bootstrapValidator('validateField', 'birthday');
API
以下是插件提供的公共方法列表。
方法使用与以下相同的格式:
methodName()
methodName(requiredParameter*, optionalParameter, ...): Type of return value
- 方法的目的
激活addField
addField(field*, options): BootstrapValidator
- 添加一个新的字段。
field
字符串| jQuery的字段名称或字段元素options
目的字段选项。如果没有定义,这些选项将通过以下方式合并:
- 从字段的HTML属性解析的选项
- 调用插件时设置的当前选项
如果要添加新字段后要执行其他任务,则触发added.field.bv事件:
$(document).ready(function() { $(form) .bootstrapValidator(options) .on('added.field.bv', function(e, data) { // $(e.target) --> The form instance // $(e.target).data('bootstrapValidator') // --> The BootstrapValidator instance // data.field --> The field name // data.element --> The new field element // data.options --> The new field options // Do something ... });});
例
- 添加动态字段
defaultSubmit
defaultSubmit(): BootstrapValidator
- 使用默认提交提交表单。
在提交表单时也不会执行任何验证。当您要在自定义提交处理程序中提交表单时,可能会使用它。
破坏
destroy()
- 破坏插件。
它将删除所有错误消息,反馈图标以及关闭插件创建的事件。
disableSubmitButtons
disableSubmitButtons(disabled): BootstrapValidator
- 禁用或启用提交按钮
disabled
布尔可以是true
或false
例
- 始终启用提交按钮
enableFieldValidators
enableFieldValidators(field*, enabled*, validator): BootstrapValidator
- 启用,禁用验证器给定字段
field
串字段名称enabled
布尔如果true
,启用字段验证器。如果false
,禁用字段验证器validator
串验证器名称。如果未设置,所有字段验证器将被启用或禁用例
- 启用,禁用验证器
getDynamicOption
getDynamicOption(field*, option*): String
- 返回可以动态设置的选项值。
例如,zipCode验证器具有country
可以动态更改select元素的选项。
field
字符串| jQuery的字段名称或元素option
串该动态选项getFieldElements
getFieldElements(field): jQuery[]
- 按照给定的名称检索字段元素。
返回表示该字段的jQuery元素的数组,或者null
如果找不到这些字段。
field
串字段名称getInvalidFields
getInvalidFields(): jQuery[]
- 返回无效字段的列表。
的getMessages
getMessages(field, validator): String[]
- 获取错误消息。
field
字符串| jQuery的字段名称或字段元素如果未定义字段,则该方法将返回所有字段的所有错误消息
validator
串验证器的名称如果未定义验证器,则该方法返回所有验证器的错误消息。
例
- 显示自定义区域中的消息
getOptions
getOptions(field, validator, option): String|Object
- 获取字段选项。
field
字符串| jQuery的字段名称或字段元素如果未定义字段,则该方法返回表单选项。
validator
串验证器的名称如果未定义验证器,则该方法返回所有字段选项。
option
串选项名称如果未定义,则该方法返回给定验证器的选项
getSubmitButton
getSubmitButton(): jQuery
- 返回显示点击的提交按钮的jQuery元素。null
如果没有点击提交按钮返回。
已验证
isValid(): Boolean
- true
如果所有表单域都有效,则返回。否则返回false
。
调用这个之后,确保已经调用了validate方法。
isValidContainer
isValidContainer(container*): Boolean
- true
如果容器中的所有字段都有效,则返回。否则返回false
。
在使用向导(例如选项卡),崩溃时,这很有用。
container
字符串| jQuery的容器选择器或容器元件isValidField
isValidField(field*): Boolean
- 检查该字段是否有效。true
如果所有的字段验证器都通过,则返回。否则返回false
。
field
字符串| jQuery的字段名称或字段元素removeField
removeField(field*): BootstrapValidator
- 删除给定字段
field
字符串| jQuery的字段名称或字段元素通过触发removed.field.bv事件,您可以在删除给定字段后执行其他任务:
$(document).ready(function() { $(form) .bootstrapValidator(options) .on('removed.field.bv', function(e, data) { // $(e.target) --> The form instance // $(e.target).data('bootstrapValidator') // --> The BootstrapValidator instance // data.field --> The field name // data.element --> The new field element // Do something ... });});
例
- 添加动态字段
resetField
resetField(field*, resetValue): BootstrapValidator
- 重置给定字段。它隐藏错误消息和反馈图标。
field
字符串| jQuery的字段名称或字段元素resetValue
布尔如果true
,该方法将字段值重置为空或删除检查/选择的属性(用于收音机和复选框)。重置表格
resetForm(resetFormData): BootstrapValidator
- 重置表格。它隐藏所有错误元素和反馈图标。所有的字段都被标记为未被验证。
resetFormData
布尔如果true
,该方法重置具有验证器规则的字段。$(form).bootstrapValidator(options);$(form).data('bootstrapValidator').resetForm();
revalidateField
revalidateField(field*): BootstrapValidator
- 重新验证给定字段。
当您需要重新验证其值由其他插件更新的字段时使用它。
默认情况下,一旦该字段已经被验证并被标记为有效的插件,该插件就不会重新验证该字段。当与其他插件一起使用时,字段值被更改,因此需要重新验证。
幕后,方法相当于:
$(form).data('bootstrapValidator') .updateStatus(field, 'NOT_VALIDATED') .validateField(field);// Or$(form).bootstrapValidator('updateStatus', field, 'NOT_VALIDATED') .bootstrapValidator('validateField', field);
field
字符串| jQuery的字段名称或字段元素updateMessage
updateMessage(field*, validator*, message*): BootstrapValidator
- 更新错误消息。
field
字符串| jQuery的字段名称或字段元素validator
串验证器名称message
串错误消息updateOption
updateOption(field*, validator*, option*, value*): BootstrapValidator
- 更新特定验证器的选项。
field
字符串| jQuery的字段名称或字段元素validator
串验证器名称option
串选项名称value
串选项值更新状态
updateStatus(field*, status*, validator): BootstrapValidator
- 更新给定字段的验证器结果
field
字符串| jQuery的字段名称或字段元素status
串可以是NOT_VALIDATED
,VALIDATING
,INVALID
或者VALID
validator
串验证器名称。如果null
,该方法更新所有验证器的有效性结果验证
validate(): BootstrapValidator
- 手动验证表单。当您想通过单击按钮或链接而不是提交按钮来验证表单时,这很有用。
$(form).bootstrapValidator(options).bootstrapValidator('validate');// or$(form).bootstrapValidator(options);$(form).data('bootstrapValidator').validate();
validateField
validateField(field*): BootstrapValidator
- 验证给定字段。
field
字符串| jQuery的字段名称或字段元素 - bootstrapValidator 中文API
- bootstrapvalidator之API学习
- bootStrapValidator
- bootstrapValidator
- bootstrapValidator
- 中文API
- 中文API
- bootstrapvalidator 校验
- bootstrapValidator验证
- Highcharts 中文API 中文手册
- sun API中文
- jfreechart 中文api参考
- JMF API 中文指导
- JFreeChart API (中文)
- 中文在线API
- JFreeChart API(中文)
- MetaWeblog API中文说明
- jfreechart中文api详解
- community declares a dependency from configuration 'compile' to configuration 'default' which is not
- Java消息队列--JMS概述
- Github-ioctlfuzzer&ioctlbf
- Memcached、Redis以及Memcached与Redis的区别
- mysql分库分表实战及php代码操作完整实例
- bootstrapValidator 中文API
- 关于module.exports与exports
- HDU 6103 Kirinriki 【dp】
- 针对 dash3 license 破解 dash4
- 【linux相识相知】独立硬盘冗余阵列-RAID
- Laravel 速查 5.2
- ArrayList相关细节
- [vijos 1776]关押罪犯
- Dijkstra 算法的 C++ 实现