BootstrapValidator中⽂⽂档⼿册
⽬前⽀持4种⼤的校验⽅式，分别是：Input（针对input、 textarea、select控件）、CompareValidator、AjaxValidator、RegexValidator、 FunctionValidator每种格式⽀持的控件类型如下：
input textarea select
校验⽅式text radio checkbox file password textarea select-one
InputValidator√√√√√√√
CompareValidator√√√√
AjaxValidator√√√√√
RegexValidator√√√√
FunctionValidator√√√√√√√
如果你⽤了不⽀持的校验功能，插件将忽略这个校验功能。
插件⽬前提⽰错误，有两种模式：showword和 showalert，即⽂字提⽰和窗⼝提⽰，下⾯的5⼤验证⽅式，针对showalert这种⽅式不是都必须的，有些配置是没有作⽤的下⾯分别罗列全局初始化和5种校验⽅式公开的属性
formValidator:⽤来做初始化的类型，必须先执⾏
属性属性名称默认值showword showalert详细解释
validatorGroup校验组“1”√√⼀个页⾯的控件可以分成多个组，分开校验
empty是否可以为空false√√
automodify 输⼊错误离开
焦点的时候，
⾃动修复错误
false√√
先给出提⽰然
后，⾃动修
复，⽬前只⽀
持text、file、
textarea三种
类型
onempty空时候的提⽰“输⼊内容
为空”
√
可以为空，为
空时候的提⽰
onshow 显⽰时候的提
⽰
“请输⼊内
容”
√
bootstrap项目
onfocus 获得焦点的提
⽰
“请输⼊内
容”
√
oncorrect 输⼊正确后的
提⽰
“输⼊正
确”
√
当你焦点离开
控件的时候，
如果输⼊正确
将出现该提⽰
onvalid 校验通过后的
回调函数null√√
参数1：对象
本⾝ 参数2：
值 校验通过
后，你还希望
执⾏⼀些操
作，你可以通
过这个属性来
执⾏。
获得焦点后要
参数1：对象
onfocusevent 获得焦点后要
追加的回调函
数
null√√
参数1：对象
本⾝
onblurevent 失去焦点后要
追加的回调函
数
null√√
参数1：对象
本⾝
tipid 显⽰错误的容
器ID
表单
ID+”Tip”
√
defaultvalue默认值null√√所有input和select表单。如果你不设置就保持原值，⼀旦设置就设为默认值。
InputValidator：
属性属性名称默认值详细解释
type⽐较类型“size”(对select⽆效)”size”：表⽰⽐较长度“value”:⽐较值。
min 最⼩长度/
值
0(对select⽆效)
max 最⼤长度/
值
99999999999999(对select⽆效)
onerror 发⽣错误的
提⽰
“输⼊错误”
defaultvalue默认值null能满⾜预设默认值的需求
CompareValidator：
属性属性名称默认值详细解释
desID要⽐较控件的ID“”要跟源⽬标进⾏⽐较的⽬标ID
operateor⽐较符号“=”⼀共有如下⼏种类型:=、!=、>、>=、<、<= datatype数据类型“string”⽬前只⽀持2种:”string”、”number”
onerror发⽣错误的提⽰“输⼊错误”
RegexValidator:
属性属
性
名
称
默认值详细解释
regexp 正
则
表
达
“”
采⽤的是显式构造函数new
RegExp(“pattern”[,”flags”]); 由于Javascript
中’\’ 被⽤作转义字符，所以在使⽤显⽰构造函数构造实
例对象的时候，需要使⽤’\\’ 代替’\’
式
例对象的时候，需要使⽤’\\’ 代替’\’
param附
加
参
数“i”g：代表可以进⾏全局匹配。i：代表不区分⼤⼩写匹配。
m：代表可以进⾏多⾏匹配。可以任意组合，当然也可以不加
参数
datatype 数
据
类
型
“string”
“string”:⾃⼰写的表达式，”enum”：枚举名。具体请见
demo3.htm，你可以⾃⼰修改附加
pageValidatorRegex.js⾥的枚举项⽬名和表达式。
onerror：发
⽣
错
误
的
提
⽰
“输⼊错
误”
AjaxValidator:⼏乎所有的属性跟$.ajax()的属性⼀样，请参考$.ajax()函数的帮助属性属性名称默认值详细解释
type请求的类型“GET”“POST” 或 “GET”
url 发送到的
URL地址
“”
datatype 返回的数据
类型
“html”xml、html、script、json
data数据“”
async 是否以异步
的⽅式发送
true
success 当请求成功
时调⽤的函
数
null
processdata⾃动处理返
回的数据为
字符串true在默认的情况下，如果data选项传进的数据是⼀个对象⽽不是字符串，将会⾃动地被处理和转换
成⼀个查询字符串
complete 当请求完成
时调⽤的函
数
null
beforesend 当请求前时
调⽤的函数
null
error 当请求失败
时调⽤的函
数
“请求失
败”
你可以⾃⼰定义这个错误，在error⾥⾃动打出
公共函数：主要是设置全局参数和判断是否通过校验函数名函数说明
jQuery.formValidator.initConfig参数：配置类型
属性默认
值
说明
validatorGroup“1”你要针对哪个组进⾏配置alertMessage false是否弹出窗⼝
onSuccess null该组校验通过后的回调函数，返回
false，阻⽌表单的提交
submitOnce false 校验通过后，是否灰掉所有的提交按钮
onError null该组校验失败后的回调函数
jQuery.formValidator.PageIsValid⼀个参数： 不是配置类型
validatorGroup“1”你要针对哪个组进⾏验证
jQuery.formValidator.IsOneValid⼀个参数： 当时设置验证的表单元素ID。返回是否校验成功的信
息。
jQuery.formValidator.SetFailState function(“tipid”,”显⽰的信息”)在showword模式下，如果你
的额外校验没有通过，你可以通过它来设置成失败信息和状态
jQuery.formValidator.GetLength function(“表单元素id”)判断表单元素的选择长度(个
数)checkbox或radiobutton表⽰选择的个数。select表⽰选择的
selectedIndex值。其它的表⽰字符长度。
问答：
1、如何实现⼀个控件，根据不同的情况，实现不同的控制？
你只需要在你的不同种情况下，重新设置你的【⼀⾏代码】
2、⼀个页⾯上我有⼏个tab页，如何实现每个Tab页上的控件单独校验？
每个Tab页上需要校验的控件，你在写【⼀⾏代码】的时候，显⽰的声明组号
3、我采⽤的页⾯上⽂字问题的⽅式，点提交的时候，有校验未通过的，除了⽂字提⽰外，还可以再弹出窗⼝提⽰吗？
这个问题很简单，你只要设置改组的全局配置，jQuery.formValidator.initConfig({onError:function() {alert(“有部分校验没有通过，请看页⾯具体提⽰”);}})
4、所有校验通过后，我还要再做别的判断可以吗？我⾃⼰的判断没有通过可以中断提交吗？
同样很简单，你页只需设置该组的全局配置，jQuery.formValidator.initConfig({onSuccess:function() {if(你的额外判断失败)return false;elsereturn true;}})
5、我有⼀组的checkbox（radiobutton）如何设置校验？
你只需在该组的第⼀个checkbox上设置校验信息即可，具体请参考demo1⾥的范例如果你该组的第⼀个控件的ID ，你可以这么写:$(“sex_1”).InputValidator({…})如果你只知道该组的name，你可以这么
写:$(“input:check[@name=’sex’]”).slice(0,1).InputValidator({…})
6、我有2个表单元素，任意⼀个元素输⼊东西就算验证通过，如何写代码？⽐如要求输⼊中⽂名字和英⽂名字任意⼀个即算校验通过。
正在开发这个功能
7、⼀个表单元素校验通过了，但是我想额外再进⾏其它的校验，出错要⾃定义错误，如何写代码？
$(“#ewjy”).formValidator({onshow:”⽆论你输⼊什么，都会提⽰你额外校验出错，错误信息⾃定
义”,onfocus:”⾄少输⼊⼀个字符”,oncorrect:”你怎么可能输⼊正确了，难道是
bug?”,onvalid:function(){$.formValidator.SetFailState(“ewjyTip”,”额外校验失败”);alert(“额外校验失败”);return false;}}).InputValidator({min:1,onerror:”这⾥⾄少要⼀个字符，请确认”});
8、如何让赋了初始值的表单元素默认校验通过
$(“#xueli”).formValidator({onshow:”请选择你的学历”,onfocus:”学历必须选择”,oncorrect:”谢谢你的配合”,defaultvalue:”b”}).InputValidator({onerror: “你是不是忘记选择学历
了!”}).DefaultPassed();

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。