1 功能简介

跨设备表单前端校验适用于表单填报时不需要与后台进行交互的条件校验,例如字段之间控件值的比较。

2 配置说明

  • 选择元数据:下拉列表会列出当前表单已选的元数据,选择需要校验的表单元数据。
  • 条件:自定义校验条件表达式,前端校验支持跨元数据取数,前端表达式写法参阅章节 表达式-前台表达式
  • 提示类型 & 提示内容:填入触发校验时的前端提示信息内容,支持常量和表达式。
  • 提示方式&提示字段选择(V8.1.0版本新增):允许配置校验提示方式和位置,目前支持两种方式,提示样式和执行规则如下:
    • (1)弹窗提示:默认提示方式,执行时机是在编辑页面点击【保存】按钮时执行校验,触发校验后以弹出确认窗的形式提示配置的提示内容。
    • (2)控件提示:选择此项需要额外选择提示信息关联展示的控件,支持选择多个(例如在校验字段之间关系时可以将这些字段都勾上,这样触发校验时可以更容易体现字段间的关系)。这类提示方式的校验条件执行时机为实时校验,且可以做到同时判断所有该类型校验,可以在页面的控件上明确提示出未通过校验的字段。
  • 页面加载后强制执行(V8.1.0版本新增):默认不勾选,勾选后可以做到编辑页面在加载完成后自动执行一次此处配置的前端校验条件,适用于例如需要对新增页面默认值或修改页面已经填好的数据进行直观查看是否有未通过校验的内容,不用等点击【保存】时才提示。

3 执行效果

例如表单实例“员工信息管理”中为避免误填,增加对入职日期和离职日期的校验,即离职日期不得早于入职日期。

【条件】表达式可以如下配置:员工信息登记时离职日期为选填项,为避免误报在比较时添加上离职日期非空的校验条件。

触发校验的提示信息分别以常量和表达式举例说明:

(1)常量
提示类型选择“常量”时可以直接填写需要提示的文本信息内容,配置如下:离职日期不得早于入职日期,请检查!

执行效果如下图所示:

(2)表达式
若提示信息需要包含一些变量,就势必要用到表达式了,此时需要注意提示内容的写法。

写法说明:提示类型选择“表达式”时,非表达式的文本内容需要使用英文引号包裹(中文引号会报错),引号内表达式无法解析,且文本内容之间需要通过“+”拼接。

例如提示内容中需要引用当前控件填写的值来提示,配置表达式写法如下:"离职日期【"+${quit_date}+"】不得早于入职日期【"+ ${onboard_date} +"】,请检查!"

执行效果如下图所示:

作者:Eric  创建时间:2023-06-10 09:28
最后编辑:Eric  更新时间:2026-04-30 18:27