1.功能简介

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

2.配置说明


1.基础配置

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

3.显示交互

树控件常规显示:

树控件下拉显示:

作者:fancy  创建时间:2026-06-13 11:14
最后编辑:fancy  更新时间:2026-08-14 18:01