1.功能简介
树控件一般用于树形数据例如省市区、组织架构等的单选、多选,支持从展示的数据中选择其中一项或多项,支持通过名称或编码搜索来查找选项。
2.配置说明

1.基础配置
- 控件数据:控件的选项数据,可选当前单元格表单中的数据视图。
- 编码字段:选择某个字段为编码字段后,在数据填报中选择某个选项后,保存数据时存的是该选项对应的编码到数据库中。
- 名称字段:选择某个字段为名称字段后,树控件中选项显示时名称显示为选择的字段对应的数据。
- 父编码字段:选择父编码字段后,控件中的数据以该字段数据为父,构成一个组织树。
- 展示方式:树控件数据选择时的显示方式,默认为常规,同时还支持下拉方式显示。
-弹窗配置:可自定义弹窗大小,包括宽度和高度。 - 标题:弹窗标题名称定义。
- 默认值:设置控件的默认值,可以设置常量或表达式。选择“常量”时可选择对应的数据作为默认值。
- 允许编辑:开启后用户可修改内容;取消则仅只读展示
- 直接显示:填报单元格里的控件默认需要鼠标点击时才显示,编辑完成后自动隐藏;勾选“直接显示”可让控件一直处于显示状态。
- 提示信息:输入浅灰色占位文案,引导用户填写内容。
2.树展示设置
- 取值字段:获取哪个字段的数据作为树节点数据。
- 叶子节点字段:可指定某个字段为叶子节点字段。
- 加载模式:默认一次性加载,支持选择“逐层加载”。
- 节点展开方式:默认不展开,支持选择“根节点展开”或“全展开”。选择对应的展开方式,数据填报时树控件数据按照选择的方式展开。
- 允许选中的节点:树控件中可以选中哪些节点。勾选“根节点”,数据填报时只允许选中根节点;勾选“枝干节点”,数据填报时只允许选中枝干节点;勾选“叶子节点”,数据填报时只允许选中叶子节点。即勾选哪个节点,在数据填报时可以选择哪个节点。
- 选择方式:默认单选。勾选多选后,选择“当前节点”,数据填报时选择选项时,只选中当前选中的选项,该选项的父节点和子节点都不选中。选择“当前节点和子孙节点”,数据填报时选择选项时,选中当前选项后若该选项有子节点则子节点都被选中。选择“递归”,数据填报时选择选项时,选中当前选项后,若该选项有父节点和子节点,则父节点和子节点都被选中。
- 数据(数据校验规则)

- 数据类型:默认字符型,统一存储文本内容
- 允许为空:开启:表单可留空提交;关闭则必填,为空拦截提交
- 为空时默认值:控件无填写内容时,自动填充该值(默认 Null)
- 最小长度 / 最大长度:限制输入字符区间,超出触发校验拦截
- 事件
事件配置:可在控件上按需配置事件,事件配置完成后在对应的时机可触发事件。
3.显示交互
树控件常规显示:
树控件下拉显示:
作者:fancy 创建时间:2026-06-13 11:14
最后编辑:fancy 更新时间:2026-08-14 18:01
最后编辑:fancy 更新时间:2026-08-14 18:01
———— 本文档对您有帮助吗?或有错误,恳请 反馈 ————
