成员选择
#
适用场景用于选择组织架构中的用户成员
#
基础能力说明#
支持绑定「关联用户模型的关联关系」字段,实现组织成员的选择该组件目前仅支持在模型应用中使用,使用方式如下:
- 在数据模型中创建「关联关系」类型字段,关联模型选择平台预置的用户模型(模型标识:sys_user)
- 在页面编辑器中,添加表单容器,绑定上述数据模型,页面中会自动生成成员选择组件(如果默认生成了下拉选择组件,可在表单容器的字段属性中,将该字段的对应组件切换为成员选择组件)
- 预览区、应用运行态,可对组织中的用户进行选择
#
常见场景实践说明#
扩展场景说明#
成员筛选该组件提供「数据筛选」属性,可通过用户模型(模型标识:sys_user)中用户信息的常规字段字段,进行成员过滤,在运行态,组件仅展示筛选范围内的成员列表
#
属性介绍组件接收的外部传入的属性
属性名 | 属性标识 | 类型 | 属性分组 | 默认值 | 说明 |
---|
绑定字段 | name | string | 基础属性 | "formUserTreeSelect" | 组件中输入/选择的内容会在提交表单时传入绑定的数据源字段中,并可回显字段中已存储的数据。 |
标题 | label | string | 基础属性 | "成员" | 表单组件标题 |
显示标题 | labelVisible | boolean | 基础属性 | true | 是否显示组件标题 |
提示文字 | placeholder | string | 基础属性 | "请选择成员" | 用于说明组件用途或注意事项的提示文字 |
选中值 | defaultValueType | {"label":"无","value":"noneUser"}|{"label":"指定成员","value":"confirmUser"}|{"label":"当前登录用户","value":"loginUser"} | 基础属性 | "noneUser" | 默认选中的人员数据,可配置为指定成员或当前登录用户 |
指定成员id | confirmValue | string | 基础属性 | "" | 仅选中值属性配置为指定成员时显示,输入用户的数据标识(_id),可在运行态默认选中该用户 |
必填 | required | boolean | 基础属性 | false | 启用后该组件强制必填,值不可为空 |
必填标识 | requiredFlag | boolean | 基础属性 | false | 启用后,组件若要求必填,则会显示必填星号标记 |
必填校验提示 | requiredMsg | string | 基础属性 | "该项为必填项" | 启用必填,但组件值为空时的提示信息 |
数据筛选 | where | array | 高级属性 | - | 对数据进行筛选过滤 |
布局方式 | layout | {"label":"自动","value":""}|{"label":"水平","value":"horizontal"}|{"label":"垂直","value":"vertical"} | 高级属性 | "" | 控制标题与输入框的布局方式,展示为水平或垂直布局 |
组件宽度(PC端) | size | {"label":"大","value":"l"}|{"label":"中","value":"m"}|{"label":"小","value":"s"}|{"label":"占满","value":"full"} | 高级属性 | "full" | 可选大、中、小、占满 |
是否禁用 | disabled | boolean | 高级属性 | false | 控制该组件是否为禁用状态 |
支持多选 | multiple | boolean | 高级属性 | false | beta属性:开启后,可获取成员多选数据,但是暂不支持将多选数据进行提交,请谨慎开启! |
#
事件介绍组件暴露的事件,可以监听组件的事件来触发一些外部的动作
事件名 | 事件code | 事件出参 event.detail | 适用情况 | 说明 |
---|
值改变 | change | 兼容三端 | 组件中的数据内容发生改变时触发 |