Valid表单校验
Valid校验模块是对表单域进行值校验,要求表单域需要填写name属性,并且最好使用form节点包裹;当提交表单的时候,validate支持二次校验;支持ajax异步校验;内置了值类型校验、值强度校验、包含字符串类型校验、数值大小校验、数值多少校验等;支持自定义校验方法。
简单使用
对文本表单域使用ax-valid
属性即可表示必填校验。校验成功与否都会在表单域下方自动创建_valid
容器。
需要注意,表单域校验,必须有name
属性以确保该表单域是真实有效,如此,校验也才有意义。
也可以通过id+new
的方式创建实例。
基础配置
属性 |
类型 |
默认值 |
说明 |
label |
string |
'' |
表单元素替代名称 |
placement |
'newline'/'note'/'popup'/'message'/'#ID'/DOM/'' |
'' |
文字展示方式 |
type |
string |
'required' |
校验类型,多个用逗号分隔 |
parent |
string |
'' |
父form节点选择器 |
separator |
string |
',' |
多值分隔符 |
nodeName |
string |
'div' |
消息容器节点名 |
fail |
string |
'' |
自定义错误信息格式 |
succ |
string |
'' |
自定义成功信息格式 |
message |
object |
{} |
Message模块参数 |
popup |
object |
{} |
Popup模块参数 |
显示配置
属性 |
类型 |
默认值 |
说明 |
iconShow |
boolean |
true |
是否显示提示图标 |
styleHost |
boolean |
false |
是否对宿主表单域使用样式 |
succShow |
boolean |
true |
校验通过是否显示提示 |
classes |
string |
'' |
追加样式类 |
校验规则配置
属性 |
类型 |
默认值 |
说明 |
extend |
object |
{} |
扩展校验类型 |
regLocal |
string |
'' |
本地文字字符正则 |
regChars |
string |
'' |
特殊字符正则 |
lengthStr |
number |
6 |
强度校验默认字符数量 |
trigger |
'blur'/'change'/'input'/'load' |
'blur' |
触发校验方式 |
ajax |
object |
{} |
异步校验参数 |
回调函数
属性 |
类型 |
默认值 |
说明 |
onTrigger |
function |
null |
事件触发后回调 |
onChanged |
function |
null |
状态变化后回调 |
onShown |
function |
null |
显示后回调 |
onHidden |
function |
null |
隐藏后回调 |