Valid表单校验

Valid校验模块是对表单域进行值校验,要求表单域需要填写name属性,并且最好使用form节点包裹;当提交表单的时候,validate支持二次校验;支持ajax异步校验;内置了值类型校验、值强度校验、包含字符串类型校验、数值大小校验、数值多少校验等;支持自定义校验方法。

简单使用

对文本表单域使用ax-valid属性即可表示必填校验。校验成功与否都会在表单域下方自动创建_valid容器。

需要注意,表单域校验,必须有name属性以确保该表单域是真实有效,如此,校验也才有意义。

  • 输出
  • HTML
  •                 
                    
                

也可以通过id+new的方式创建实例。

  • 输出
  • HTML
  • JS
  •                 
                    
                
  •                 
                    new ax.Valid('#demo01');
                    
                

基础配置

属性 类型 默认值 说明
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 隐藏后回调