跳到主要内容

成员选择

FormDepartTreeSelect

适用场景

用于选择组织架构中的用户成员

基础能力说明

支持绑定「关联用户模型的关联关系」字段,实现组织成员的选择

该组件目前仅支持在模型应用中使用,使用方式如下:

  1. 在数据模型中创建「关联关系」类型字段,关联模型选择平台预置的用户模型(模型标识:sys_user)
  2. 在页面编辑器中,添加表单容器,绑定上述数据模型,页面中会自动生成成员选择组件(如果默认生成了下拉选择组件,可在表单容器的字段属性中,将该字段的对应组件切换为成员选择组件)
  3. 预览区、应用运行态,可对组织中的用户进行选择

常见场景实践说明

了解更多的表单组件使用场景,可查阅 表单常见场景实践指南

扩展场景说明

成员筛选

该组件提供「数据筛选」属性,可通过用户模型(模型标识:sys_user)中用户信息的常规字段字段,进行成员过滤,在运行态,组件仅展示筛选范围内的成员列表

属性介绍

组件接收的外部传入的属性

属性名
属性标识
类型
说明
绑定字段namestring

组件中输入/选择的内容会在提交表单时传入绑定的数据源字段中,并可回显字段中已存储的数据。

示例:"formUserTreeSelect"

标题labelstring

表单组件标题

示例:"成员"

显示标题labelVisibleboolean

是否显示组件标题

示例:true

提示文字placeholderstring

用于说明组件用途或注意事项的提示文字

示例:"请选择成员"

选中值defaultValueTypestring

默认选中的人员数据,可配置为指定成员或当前登录用户

示例:"noneUser"

指定成员idconfirmValuestring

仅选中值属性配置为指定成员时显示,输入用户的数据标识(_id),可在运行态默认选中该用户

示例:""

展示企业范围corpScopearray

支持写入企业id,用于限制组件中展示的企业列表

填写企业id后,只展示这些企业下的部门和用户

示例:[]

必填requiredboolean

启用后该组件强制必填,值不可为空

示例:false

必填标识requiredFlagboolean

启用后,组件若要求必填,则会显示必填星号标记

示例:false

必填校验提示requiredMsgstring

启用必填,但组件值为空时的提示信息

示例:"该项为必填项"

辅助展示信息secondDisplaystring

可选当前用户模型中的字段作为辅助展示信息,以便识别重名人员

示例:""

数据筛选wherearray

对数据进行筛选过滤

布局方式layoutstring

控制标题与输入框的布局方式,展示为水平或垂直布局

示例:""

组件宽度(PC端)sizestring

可选大、中、小、占满

示例:"full"

是否禁用disabledboolean

控制该组件是否为禁用状态

示例:false

支持多选multipleboolean

beta属性:开启后,可获取成员多选数据,但是暂不支持将多选数据进行提交,请谨慎开启!

示例:false

事件介绍

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
值改变change兼容三端

组件中的数据内容发生改变时触发

属性 API

通过属性 API,可以获取组件内部的状态和属性值,可以通过$w.componentId.propertyName 来访问组件内部的值,如 $w.input1.value ,详请请参考 [属性 API](https://docs.cloudbase.net/lowcode/components/wedaUI/src/docs/compsdocs/weda-design/WidgetAPI)

只读属性名
属性标识
类型
说明
输入值valuestring

方法 API