Skip to content

表单验证规则

表单验证是确保用户输入数据有效性的重要功能。FormCreate 设计器提供了丰富的验证规则类型,帮助您快速配置各种验证场景。

注意

  • 验证触发时机:支持 blur(失焦)、change(值改变)、submit(提交)三种触发方式

  • 自定义验证中可通过 this.rule 和 this.api 获取组件和表单的相关信息,便于在验证时访问其他组件的值。

  • pattern 类型为 string 时,前后不能包含 / 符号,否则会导致正则表达式无效。

  • 自定义验证中无论成功或失败,都必须执行 callback 回调函数。

验证规则类型

在右侧「验证」面板中点击「验证规则 +」,下拉列表会同时展示规则名称与说明文字,便于快速选择合适的校验类型。设计器支持以下验证规则:

基础验证规则

Key规则名称功能描述
len长度字符数/数字长度或选项个数必须等于设定值
minLen最小长度字符数/数字长度或选项个数不能少于设定值
maxLen最大长度字符数/数字长度或选项个数不能超过设定值
min最小值数值不能小于设定值
max最大值数值不能大于设定值

格式验证规则

Key规则名称功能描述
pattern正则表达式输入内容必须匹配填写的正则表达式
email邮箱格式必须是合法的邮箱地址,如 name@example.com
urlURL格式必须是 http / https / ftp 开头的完整网址
ipIP地址必须是合法的 IPv4 地址,如 192.168.1.1
phone手机号必须是中国大陆手机号,可带 +860086

字符与数值规则

Key规则名称功能描述
uppercase全大写只能包含大写英文字母 A-Z
lowercase全小写只能包含小写英文字母 a-z
positive正数必须是大于 0 的数字(0 和非数字都不通过)
negative负数必须是小于 0 的数字(0 和非数字都不通过)
integer整数必须是整数,不能带小数
number数字必须能转为有效数字(可为小数、负数、0)

高级验证规则

Key规则名称功能描述
validator自定义验证用自定义函数判断,自行调用 callback 返回结果
computed条件验证用公式/条件判断,条件成立则验证通过

通过这些验证配置,您可以构建出功能完善、用户友好的表单验证系统。