跳到主要内容

部门选择

适用场景#

用于选择组织架构中的各级部门

基础能力说明#

支持绑定「关联部门模型的关联关系」字段,实现组织部门的选择#

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

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

常见场景实践说明#

  1. 实现通过变量获取和改变表单值 查阅文档
  2. 清空表单内容 查阅文档

属性介绍#

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

属性名
属性标识
类型
属性分组
默认值
说明
绑定字段namestring基础属性"formDepartTreeSelect"提交表单时会将组件值提交保存到所配置的字段中
标题labelstring基础属性"部门"表单组件标题
显示标题labelVisibleboolean基础属性true是否显示组件标题
提示文字placeholderstring基础属性"请选择部门"用于说明组件用途或注意事项的提示文字
选中值defaultValueType{"label":"无","value":"noneDepart"}|{"label":"指定部门","value":"confirmDepart"}基础属性"noneDepart"默认选中的部门数据,可配置为指定部门
指定部门idconfirmValuestring基础属性""仅选中值属性配置为指定部门时显示,输入部门的数据标识(_id),可在运行态默认选中该部门
可选范围departmentScopearray基础属性[]填写部门id后,可选择范围内的各部门
必填requiredboolean基础属性false启用后该组件强制必填,值不可为空
必填标识requiredFlagboolean基础属性false启用后,组件若要求必填,则会显示必填星号标记
必填校验提示requiredMsgstring基础属性"该项为必填项"启用必填,但组件值为空时的提示信息
布局方式layout{"label":"自动","value":""}|{"label":"水平","value":"horizontal"}|{"label":"垂直","value":"vertical"}高级属性""控制标题与输入框的布局方式,展示为水平或垂直布局
组件宽度(PC端)size{"label":"大","value":"l"}|{"label":"中","value":"m"}|{"label":"小","value":"s"}|{"label":"占满","value":"full"}高级属性"full"可选大、中、小、占满
是否禁用disabledboolean高级属性false-
支持多选multipleboolean高级属性falsebeta属性:开启后,可获取部门多选数据,但是暂不支持将多选数据进行提交,请谨慎开启!

事件介绍#

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

事件名
事件code
事件出参 event.detail
适用情况
说明
值改变change兼容三端组件中的数据内容发生改变时触发