树形组件作为分类查询列表的使用说明
· 阅读需 3 分钟
通过树形组件实现“分类筛选”功能:点击树形节点时,自动将节点值作为查询条件,刷新表格数据,展示对应分类下的内容。
二、配置步骤
1. 准备工作
- 确认树形组件需展示的分类数据(如“部门”“产品分类”等),以及表格需展示的明细数据(如“部门成员”“产品列表”等);
- 确保后端接口支持“按树形节点值查询”(如接口需接收
category_id参数,返回对应分类的表格数据)。
2. 配置树形组件数据结构
- 数据格式要求:需为嵌套 JSON 结构,至少包含 3 个核心字段:
[
{
"id": "1", // 节点唯一标识(作为查询入参的核心值)
"label": "技术部", // 节点展示名称
"children": [ // 子节点(可选,无下级则省略)
{"id": "1-1", "label": "前端组"},
{"id": "1-2", "label": "后端组"}
]
},
{
"id": "2",
"label": "市场部",
"children": []
}
]
- 配置方式:在组件编辑页,将上述格式数据填入“树形数据源”字段(支持静态数据直接输入,或通过接口动态获取)。

3. 配置表格数据
- 按常规表格配置步骤设置列信息(如“姓名”“职位”等);
- 确保表格查询接口包含“分类筛选参数”(如
category_id,与树形节点id对应); - 示例接口参数:
{ "category_id": "", "page": 1, "size": 10 }(category_id初始为空时,默认展示全量数据)。
4. 关联树形组件与表格(核心交互)
- 设置查询入参映射:在表格的“查询参数配置”中,将“树形组件选中值”绑定到表格的
category_id参数(即:表格查询时,自动带上树形组件当前选中节点的id); - 配置刷新事件:在树形组件的“事件配置”中,选择“节点点击事件”,触发动作设为“刷新表格”(即:点击任意树形节点后,自动调用表格的查询接口,加载对应分类数据)。
三、效果验证
配置完成后,操作流程如下:
- 页面加载时,树形组件展示完整分类结构,表格默认展示全量数据;
- 点击树形节点(如“前端组”),表格自动以
category_id=1-1为条件查询,刷新展示“前端组”的明细数据; - 切换节点(如“市场部”),表格实时更新为对应分类数据。
四、注意事项
- 树形节点
id需与表格查询接口的分类参数(如category_id)类型一致(均为字符串或数字); - 若需“默认选中某个节点”,可在树形组件配置中设置“默认选中值”(如
defaultCheckedKeys: ["1"]),页面加载时自动触发首次查询。