进阶 docs.budibase.com 2026-11-12 08:33:37 · 20 阅读

第54章 Relationship Picker(关联选择器)使用指南

Relationship Picker(关联选择器)

使用 Relationship Picker 为关系字段选择数据行。把它添加到 Form 中,然后在 Field 里选择对应的 relationship 列。

关系设置决定了选择器是单选还是多选,选项会自动从关联表中加载。

工作原理

选择器使用:

- 关联表的 display column 作为选项标签 - 关联行的 _id 作为选项值

即使选择器只允许单选,relationship 字段返回的仍是行 ID 数组。例如:

["ro_ta_123"]

默认值

将 Default value 设置为关联表中 ID 组成的数组。可以直接输入已知的 ID,也可以通过绑定动态生成。

例如,为关联表添加一个 Data provider,筛选出你想默认选中的行,然后用 JavaScript 绑定:

return $("City Data Provider.Rows")?.map(row => row._id)

筛选选项

打开 Filtering 可以限制用户能选中哪些关联行,比如让 City 选择器只显示另一个字段中已选国家对应的城市。

当筛选配置或绑定的筛选值发生变化时,Budibase 会清空当前选中项,避免已失效的行仍处于选中状态。

选择器每次最多加载 100 个选项。启用 Search 后,用户可以在关联表的 display column 中搜索初始列表之外的行。

完整示例请参阅 Cascading dropdown filters。

按已选关系筛选数据

Relationship Picker 的值是 ID 而非显示标签。用它来筛选关联的 SQL 数据时:

- 在要限制的组件或 Data provider 上添加筛选 - 选择关联行的 ID 字段,如 Relationship._id - 使用 Is in 操作符 - 将筛选值绑定到 Relationship Picker 字段

_id 子字段专门用于 SQL 关系筛选字段,以便与选择器输出的值进行比较。

On change

使用 On change 可以在选中项变化时执行动作。Field Value 中包含已选 ID 的数组。

如果单选场景下需要完整的关联行:

- 添加一个 Fetch Row 动作并选择关联表 - 将 Row ID 设为第一个选中的 ID,例如 {{ Field Value.[0] }} - 在后续动作中使用 {{ Action 1.Fetched row }}

相关页面

- Relationships - Forms - Cascading dropdown filters - Chaining actions

更新于 9 天前 此页面有帮助吗?

评论 (0)