ValidatorPanel
表单验证组件对所有带有data-validate属性的子元素input输入框进行验证
rules属性提供的规则有
required:是否必填
date:日期格式验证
number:是否是有效的号码
url:url规则验证
dateISO:日期ISO验证
digits:是否是数字
equalTo:值对比
minlength:最少输入
maxlength:最大输入
email:邮箱验证
rangelength:字符大小需在某个区间之内
min:输入的值需要大于等于此规则定义的值
max:输入的值需要小于等于此规则定义的值
range:一个区间取值范围
自定义,比如rules:{
checkbox:{
required:true,
//自定义规则
isValueToNumber:{
text:'value值不是数字',
rule:function(value){
return !isNaN(value-0);
}
}
}
}
会验证name为checkbox的输入控件。
自定义的规则作为key、value配置,validator会依据rule方法返回的true或者false来决定是否提示text中的文案
属性
| 属性名 | 类型 | 说明 | 默认值 |
|---|---|---|---|
componentTag
|
String |
包装容器 |
form |
direction
|
String |
提示方位 |
right |
getValueCallback
|
Function |
每次验证时值被改变后都会被触发,会回传当前data-field字段、值和所有值对象 |
|
message
|
Object |
默认规则提示文案 |
required: '不能为空', date: '请正确填写日期', number: '请输入一个有效的号码', url: '请输入一个有效的URL', email: '请输入一个有效的电子邮件地址', dateISO: '请输入一个有效的日期(ISO)', digits: '请输入数字', equalTo:'请再次输入相同的值。', minlength: '请输入至少{0}字符', maxlength: '请输入不超过{0}字符', rangelength: '请输入一个值{0}和{1}字符之间', min: '请输入一个值大于或等于{0}', max: '请输入一个值小于或等于{0}', range: '请输入一个值{0} - {1}' |
rules
|
Object |
规则验证 |
|
shake
|
Boolean |
是否增强文本框提示 |
true |
submitElement
|
String |
提交按钮id |
|
timeout
|
Number |
提示框消失时间 |
3000 |
trigger
|
String |
触发验证的事件集合 |
blur keyup focus click |
update
|
String |
重新更新dom |
+new Date() |
values
|
Object |
需要初始化的表单元素默认值(废弃) |
事件
| 方法名 | 说明 | 回调参数 |
|---|---|---|
submitCallback
|
自定义在提交后的callback |
optObject
表单数据结构 |
validateCallback
|
自定义验证规则之外的其他逻辑 |
optObject
表单数据结构 |