更新时间:2025-08-15 GMT+08:00
分享

设置物料插件的“选择器”组件属性

适用场景

“选择器”组件适用于用户在流程中从预设选项中选择一个或多个值的业务场景。它常用于枚举型数据的输入、流程参数的配置、角色/人员的选择、分类项的绑定等,适合需要限制用户选择范围、规范数据录入的场合。

基础信息

属性名

说明

支持变量绑定

组件名

选择器组件的名称,默认为“选择器”,不可修改。

×

rel引用类

选择器组件的ID,系统自动生成,且不可修改。

×

Style

配置选择器组件样式,支持通过CSS代码自定义选择器组件的样式。

默认值

设置选择器的预设选中值,需从“数据类型”配置的选项中选取(如默认选中“选项 A”)。

多选

设置是否支持选择多个选项

  • 仅可选择一个选项(单选模式)
  • 可选择多个选项(多选模式,选中项以标签形式展示)

禁用

设置选择器是否禁用。

  • 允许正常展开选项并选择
  • 组件置灰,无法点击或展开选项

数据标识字段

当选择器绑定值为对象类型(如选项数据为“{id:1, name:' 选项 A'}”)时,需指定用于唯一标识选项的键名(“id”“code”)。

配置后需与组件底层属性对应:“el-select”需添加“value-key='指定键名'”“el-option”需绑定“:key='item.指定键名'”,确保系统准确识别与存储选中项。

数据展示字段

当选择器绑定值为对象类型时,需指定用于在选择框中展示选项文本的键名(如“name”“label”)。例如选项数据为“{id:1, name:' 选项 A'}”如果此处填“name”,则选择框中会显示“选项 A”,而非原始对象数据。

占位符

设置选择器未选中时的提示文本(如“请选择”“请选择人员”

如果您希望在切换语言时,占位符同步切换,可单击进行相关配置,具体操作请参见使用国际化词条

更多选项类型

属性名

说明

支持变量绑定

数据类型

用于配置选择器的可选选项列表,选项将在下拉面板中展示供用户选择支持以下格式:

  • 基础值列表:纯数值或字符串数组(如[1, 2, 3]['选项A', '选项B']
  • 对象列表:包含标识与展示信息的对象数组(如[{id:1, name:'选项A'}, {id:2, name:'选项B'}],需配合“数据标识字段”“数据展示字段”使用)。

高级配置

属性名

说明

支持变量绑定

是否渲染

在页面开发中,可能需要根据某些条件来动态显示或隐藏页面中的组件内容,您可以设置此配置项。

  • :关闭渲染。
  • :开启渲染。

循环数据

表示需要循环渲染的数组。当页面存在若干份重复的、动态生成的内容时,您可以在高级面板中自定义循环数据。

迭代变量名

在循环渲染子项对应的变量名,默认为item。

×

索引变量名

循环渲染的索引变量名,默认为index。

×

key

用于标识每个循环项的唯一键值,默认为index。建议根据实际需求选择一个更合适的字段作为唯一标识符,以提高性能和避免潜在问题。

×

相关文档