Skip to content

验证配置 ​

验证配置保证提交前数据合格:必填、格式、长度、范围,以及 自定义验证、条件验证。优先用界面提供的规则;只有内置规则不够时再用自定义。

验证配置入口

在哪里找 ​

选中字段 → 右侧 组件配置 → 验证配置。

验证配置入口

注意区分:

能力在哪里做什么
是否必填验证配置这个字段始终必填
验证规则验证配置 → 验证规则 +格式、长度、自定义、条件验证等
必填条件高级配置按条件才变成必填

怎么用(分步) ​

1. 打开验证配置 ​

  1. 选中要校验的字段(如「手机号」)。

选中手机号

  1. 右侧找到 验证配置。

验证配置

2. 设置是否必填 ​

  1. 打开 是否必填 开关。

是否必填

  1. 点顶部 预览,空着提交,应出现必填提示。

校验失败提示

3. 添加验证规则 ​

  1. 在验证配置里点 验证规则 +。

验证规则加号

  1. 在弹出的 验证规则类型列表 里浏览可选规则(长度、邮箱、手机号、自定义验证、条件验证等)。

验证规则类型列表

  1. 选中一种规则后,在卡片里核对参数(如验证方式、错误信息)。

规则卡片参数

规则类型说明 ​

以界面列表为准,常见包括:

类型用途
是否必填不能为空(开关,不一定走规则列表)
长度 / 最大长度 / 最小长度字数或选项个数
邮箱格式 / URL格式 / 手机号 / IP地址常见格式
最小值 / 最大值 / 正数 / 整数 / 数字数值范围与类型
正则表达式 / 全大写 / 全小写自定义格式约束
自定义验证用函数写特殊规则
条件验证用逻辑条件决定「验证通过 / 未通过」

场景示例 ​

入门:手机号必填 + 格式 ​

背景:访客登记手机号不能空,且须是手机号格式。

步骤:

  1. 选中「手机号」,确认 是否必填 已打开。

选中并开启必填

  1. 点 验证规则 +。

点验证规则加号

  1. 在类型列表中找到并准备选择 手机号。

列表中的手机号

  1. 添加后填写 错误信息(如「请输入正确的手机号」)。

填写错误信息

  1. 预览:不填或填错格式后提交,确认字段旁出现提示。

预览格式校验

预期:不合格数据无法提交。

入门:备注最大长度 ​

背景:来访事由最多 200 字。

步骤:

  1. 选中「来访事由」,打开右侧 验证配置。

选中来访事由

  1. 点 验证规则 +。

验证规则加号

  1. 在类型列表中选 最大长度。

选择最大长度

  1. 在规则卡片里把最大长度设为 200,并写好错误信息。

配置最大长度

  1. 预览 粘贴超长文本后提交,确认拦截。

预览超长提示

预期:超长无法通过校验。

常用:条件验证 ​

背景:希望用字段条件控制本字段是否通过校验(例如依赖「姓名」是否已填)。适合点选配置,不必写函数。

步骤:

  1. 选中「手机号」,定位到 验证配置。

选中字段打开验证

  1. 点 验证规则 +,在列表底部附近选 条件验证。

列表选择条件验证

  1. 在规则卡片上看到 配置表达式 入口。

条件验证卡片

  1. 点 配置表达式,在 逻辑条件 里配「姓名 不为空」,并选择条件成立后是 验证通过 还是 验证未通过。

配置条件表达式

  1. 回到规则卡片,填写 错误信息。

条件验证错误信息

  1. 预览 不同填写情况,确认提示符合预期。

预览条件验证

预期:用字段条件控制本字段是否通过校验。长期「某种情况下才必填」优先看必填条件;条件验证更适合「通过 / 不通过」的规则表达。运算符细节见使用逻辑条件。

常用:自定义验证 ​

背景:内置规则不够时(特殊工号、多字段交叉判断等)再用 自定义验证。以点选添加为主;函数内容可让懂规则的同事维护。

步骤:

  1. 选中目标字段,打开 验证配置。

打开验证配置

  1. 点 验证规则 +,在列表中选 自定义验证。

列表选择自定义验证

  1. 在规则卡片里确认 验证方式、自定义验证 入口和 错误信息。

自定义验证卡片

  1. 点 自定义验证,打开编辑窗口:不通过时 callback('提示文案'),通过时 callback()。

自定义验证编辑窗口

  1. 确定后 预览 合法 / 非法输入。

预览自定义验证

预期:特殊规则也能在提交前拦住。能用手机号、长度、条件验证解决的,不必上自定义。

触发与体验 ​

  • 规则上常有 验证方式(如失去焦点、改变、提交)。
  • 错误文案写清楚「该怎么改」,避免只写「校验失败」。
  • 表单级还可配置是否行内展示错误等,见表单配置。

与其它能力配合 ​

需求配合
仅某些情况下必填必填条件(高级配置)
条件验证里的字段比较使用逻辑条件
提交前确认事件配置 / 事件流配置
多语言错误文案国际化

注意点 ​

  • 「是否必填」≠ 高级「必填条件」≠ 验证规则里的「条件验证」。
  • 改字段 ID 后检查自定义 / 条件验证是否仍引用旧字段。
  • 正则与自定义规则务必用预览多测边界值。
  • 优先内置规则,再条件验证,最后才自定义验证。

相关阅读 ​

相关技术文档 ​