数据联动
数据联动是表单中使用率非常高的一项功能,可以用来对另一张表单中已经录入的数据,进行直接调用,或者有条件地调用,使得当前字段展示设定好的值;如果联动数据来自接口、外部上下文或统一数据集,通常还会继续配合远程请求、导入外部数据与预定义全局数据使用。
应用场景
在地址选择时,第一个下拉框选择江苏省,第二个下拉框只能选择江苏省对应的城市;第一个下拉框选择浙江省,第二个下拉框只能选择浙江省对应的城市;这种设置就是应用了数据联动的思想。
在商品信息调用时,选择了某个商品名称或编号后,下面的空格自动填入该商品的价格。
设置入口

对于以下字段,选中字段后,均在「组件配置 >> 高级配置」处设置「数据联动」:

点击数据联动之后,打开数据联动设置弹窗;


当满足条件的时候可以展示其他字段的值。
支持字段
支持设置「数据联动」的字段包括:输入框、多行输入框、密码输入框、提及、分段控制器、数字输入框、单选框、多选框、选择器、开关、评分、时间、时间区间、滑块、日期、日期区间、颜色选择器、级联选择器、上传、穿梭框、树形控件、树形选择、省市区选择器、富文本框、唯一值、手写签名、计算公式、子表单选择器、插槽区域、动态区域
应用示例
示例1:
在采购订单表单中,选择产品名称后,系统自动从产品表中获取该产品的单价、库存数量,并显示在表单中。若库存不足,提示用户或限制下单数量。
示例2:
销售人员在创建订单时,选择客户名称后,系统自动从客户数据库中提取该客户的联系电话、地址、历史订单记录等信息,填充到订单表单的对应字段中。
与组件联动的区别
数据联动主要解决“把什么值带到目标字段”的问题,而组件联动主要解决“目标字段应该显示、隐藏、禁用还是必填”的问题。两者常常配合使用,但关注点不同。
联动结果说明
配置数据联动时,建议先明确三件事:
- 来源字段:由哪个字段或数据源触发联动。
- 目标字段:联动结果最终写入哪个字段。
- 触发条件:在什么条件下执行回填,以及不满足条件时是否保留原值。
如果你希望在事件里自己控制回填时机或回填内容,也可以直接结合表单 API中的 getValue、setValue、getRule 等方法实现,这样更适合处理带接口请求或多步骤判断的联动逻辑。


