树组件
树组件主要用于展示具有层次结构的数据,如文件目录、组织架构、商品分类等。它能直观地显示父子关系,支持节点展开收起、选择操作,为用户提供清晰的数据导航体验。JitAi的树组件分为树形组件和级联树组件。
树形组件
树形组件为最常用的树组件,可用于展示多级数据,树形组件默认只展示第一级数据,点击>
图标后,会查询下一级数据:
如下图所示,树形组件的各层级字段均来自同一数据表模型的不同字段。
创建树形组件
在页面编辑器中拖入树形组件后,在预览区会显示配置出错,这是因为基础配置
中的层级字段配置不全。当开发者选择完层级字段后,就会按照配置正确的渲染出树形组件。
配置层级字段
鼠标点击一级字段
下的请选择
,在下拉框中选择一级字段。然后按照同样的操作配置其他层级的字段。树形组件要求最少配置两级字段。最多可配置5级。
使用效果:
树形组件首次加载组件时刷新数据
本配置项是指在页面上树形组件加载完毕后,是否立即调用接口获取数据,默认情况下会勾选本选项。当需要其他组件加载完再加载树形时,可以不勾选本选项。下面是点击按钮后手动加载树形组件数据的示例:
使用效果:
默认展开第一个节点
在默认情况下,树形组件渲染后所有节点都是闭合状态,勾选本选项后,会在组件渲染完后默认展开第一个节点,并展示第一个节点的下级节点:
点击节点后事件
点击树组件任一层级的节点时会触发此事件,可用于更新其他组件的数据。常见应用场景:使用树形组件展示层级关系,使用表格展示详细数据,点击树节点时联动更新表格内容。此场景下,树形组件与表格需使用相同的数据表模型:
配置步骤如下:
- 在树形组件的事件配置区的
点击节点后
事件编辑区,点击请选择
,在弹框中选择表格
的刷新
方法。 - 点击
设置筛选条件
右边的设置
按钮(看起来像三条横线),然后选择变量值。 - 点击
请选择
,在弹窗中选择树形的节点的筛选条件
的值
。
使用效果如下图:
级联树
级联树组件与树形组件类似,也用来展示具有层级关系的数据。与树形组件不同的是使用的数据结构不同,如下图所示,数据模型中需要有一个自关联字段。
自关联字段
关联单选字段,目标数据模型
和字段所处的数据表模型是同一个。
本示例所用数据如下图,每一层的数据通过上一层级
字段关联其他数据,最顶层的数据的上一层级
字段为空。
配置好后效果:
新建级联树
在页面编辑器中拖入级联树后,组件会默认选择非主键id的第一个字段作为标题字段,选择第一个自关联字段为上级节点。
在使用级联树的时候,默认只查询第一层级的数据,当点击层级前面的>
按钮后,会展示下一层级的数据。
配置节点标题
当组件默认选择的节点标题不符合用户需求时,开发者可自行修改:
点击节点标题
下面的标题字段的名称,在下拉框中选择新的节点标题。
设置上级节点
当数据表模型中有多个自关联字段时,用户可根据实际需求修改上级节点字段。
点击上级节点
下的字段名称,在下拉框中选择新的上级节点
字段。
节点单选/多选
组件默认为单选模式,用户可根据需求设置为多选模式。
用户点击模式
下的单选
或多选
进行切换。
级联树首次加载组件时刷新数据
本配置项是指在页面上级联树组件加载完毕后,是否立即调用接口获取数据,默认情况下会勾选本选项,使用方法与树形组件的首次加载组件时刷新数据相同,在此不再赘述。
级联树点击节点后事件
当用户点击级联树节点后,会触发本事件。在事件编辑区,可以获取到当前点击节点的详细数据。
可以通过如下配置在点击节点后,页面提示节点的值:
配置步骤如下:
- 选中级联树组件,在右侧事件配置区找到
点击节点后
事件编辑区。 - 点击
请选择
,在弹窗中选择反馈提醒
下的全局提醒
。 - 点击
设置消息内容
右边的设置
按钮,选择变量值。 - 在弹窗中选择级联树的
操作的单行数据
中的相应字段值(如负责人的值)。
级联树选中节点后事件
当用户把模式
设置为多选
后,点击级联树中的选择框时触发本事件。
下面是一个简单的示例,可在节点勾选后全局提示勾选的负责人信息:
配置详细步骤如下:
在事件配置区找到选中节点后
事件,点击循环遍历语句。
点击请选择循环的变量
。
选择级联树下的选中的多行数据
的负责人。
点击循环语句内的请选择
按钮。
选择反馈提醒
下的全局提醒
。
最后,设置变量值为遍历项
的值。