下拉多选

介绍

在 NocoBase 中,下拉多选(Multiple select) 用于从一组选项中选择多个值。

下拉多选适合标签、能力、偏好、适用范围等字段。它保存的是多个选项值,页面中通常以标签形式展示。

如果只能选择一个值,选择下拉单选单选框组

适用场景

下拉多选适合这些业务场景:

  • 客户标签、用户偏好
  • 产品适用场景、设备能力
  • 项目风险点、问题分类
  • 可选择多个固定值的字段

创建配置

在数据表的「Configure fields」页面中,点击「Add field」,选择「下拉多选」可以创建下拉多选字段。

20240512180236

配置说明
Field interface字段的界面类型。下拉多选对应 multipleSelect,决定页面中如何录入和展示。
Field display name字段在界面中显示的名称,比如「客户标签」「适用场景」「问题分类」。建议使用业务人员能直接理解的名称。
Field name字段标识名称,用于 API、关系字段、权限、工作流等内部引用。创建后通常不再修改,只支持字母、数字和下划线,并且必须以字母开头。
Field type字段在数据层的类型。下拉多选通常保存为数组或 JSON,具体以字段配置和数据源能力为准。
Default value默认值。新增记录时,如果用户没有填写,可以自动带出默认值。
Validation rules校验规则。通常配置必填和选项范围。
Description字段说明。适合写字段含义、填写要求、数据来源或维护人。
注意

字段名创建后会被页面区块、权限、工作流和 API 引用。创建前先确认命名,避免后续修改带来配置调整成本。

字段特性

下拉多选字段的默认行为如下:

特性说明
默认 Field interfacemultipleSelect
默认 Field typearray
可选 Field typearrayjson,以实际字段映射为准。
页面组件编辑模式使用多选下拉选择器。
筛选支持按包含某个选项筛选。
排序通常不用于排序。
校验支持必填和选项范围约束。

编辑配置

创建后,点击字段右侧的「Edit」可以编辑下拉多选字段配置。编辑字段主要用于调整字段在 NocoBase 中的展示和使用方式,比如修改显示名称、说明、默认值、校验规则或字段专属配置。

如果字段来自主数据库中已经同步的表,编辑时通常是在做字段映射——把数据库字段映射为 NocoBase 的 Field type 和 Field interface。

配置允许编辑说明
Field display name修改字段在界面中的显示名称,不改变字段标识名称。
Field name字段标识名称创建后通常不能在编辑表单中修改。
Field interface条件支持主数据库字段或同步字段在字段映射时可以调整。调整后会影响页面输入、展示和校验方式。
Field type条件支持主数据库字段或同步字段在字段映射时可以调整。调整前需要确认已有数据能否按新类型使用。
Default value调整新增记录时的默认值。
Validation rules调整字段校验规则。
Description补充字段含义、填写要求、数据来源或维护人。
注意

切换 Field type 或 Field interface 不等于简单改一个显示名称。它会影响字段的存储方式、输入组件、校验规则、筛选条件和工作流变量使用方式。已有数据较多时,先确认数据格式是否匹配。

删除字段

点击字段右侧的「Delete」可以删除下拉多选字段。主数据库中还可以勾选多个字段后批量删除。

删除主数据库中新建的下拉多选字段时,通常会同时删除数据库中的真实列及该列已有数据。删除从数据库同步或外部数据源映射出的字段时,影响范围取决于对应数据源和字段来源。

警告

删除字段可能影响页面区块、表单、筛选、权限、工作流、API、导入导出和已有数据。删除前先确认字段是否仍被业务配置引用。

页面配置使用

下拉多选字段适合表达多个标签或多个固定选项。 20260709230017

场景用途
表单区块从选项中选择多个值。
表格区块以多个标签展示选项。
筛选区块按包含某些标签筛选。
工作流和权限作为包含、不包含等条件参与判断。

相关链接

  • 字段 — 了解字段的作用、分类和映射逻辑
  • 普通表 — 在普通表中创建和管理字段
  • 下拉单选 — 从选项中选择一个值
  • 复选框组 — 以复选框方式选择多个值