跳到主要内容

树形组件作为分类查询列表的使用说明

· 阅读需 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"]),页面加载时自动触发首次查询。