校验规则

注意

推荐使用 FormCreate 内置的全新验证引擎进行表单验证，表单校验(新版)

Form props

在表单中如何使用验证规则

验证规则说明

键名	说明	类型
required	是否为必选字段，当值为空值时（空字符串、空数组、false、undefined、null ），校验不通过	boolean
message	错误提示文案，可以设置为一个函数来返回动态的文案内容	string | (value, rule) => string
validator	通过函数进行校验，可以返回一个 Promise 来进行异步校验	(value, rule) => boolean | string | Promise
pattern	通过正则表达式进行校验，正则无法匹配表示校验不通过	RegExp
trigger	设置本项规则的触发时机，优先级高于 Form 组件设置的 validate-trigger 属性，可选值为 onChange、onBlur、onSubmit	string | string[]
formatter	格式化函数，将表单项的值转换后进行校验	(value, rule) => any
validateEmpty	设置 validator 和 pattern 是否要对空值进行校验，默认值为 true，可以设置为 false 来禁用该行为	boolean

注意

• Vant 的 validator 返回 boolean、string 或 Promise，不需要 callback
• Vant 的 message 可以是函数，用于返回动态的错误提示文案
• Vant 的 trigger 可选值为 onChange、onBlur、onSubmit
• 自定义验证中可通过 this.rule 和 this.api 获取组件和表单的相关信息

常见校验示例

1. 必填字段校验

2. 长度校验

最小长度校验

最大长度校验

3. 正则表达式校验

邮箱校验

4. 数字范围校验

5. 自定义校验

自定义校验（访问其他字段）

6. 异步校验

7. 数组/多选校验

最小选中项校验

最大选中项校验

8. 动态错误提示

9. 组合校验

10. 条件校验

11. 格式化后校验