1. 概述

1.1. 功能介绍

树状筛选器通常用于展示有层级关系的筛选内容，根据实际应用场景，支持在筛选时对叶节点单独过滤，也可以直接对子节点过滤；当层级复杂且选项数量较多时，树形结构也便于查找。

1.2. 应用场景

常见的应用场景：

• 国家地理信息：「国家-省份-城市-区-县」;

• 集团型企业，多级管理部门：「集团-分公司-部门」;

• 电商行业，多级品类/标签;

• 银行业的层级结构：「总行-分行-支行」。

2. 操作步骤

2.1. 新建树状筛选器

在页面中，有两个入口可以新建树状筛选器，分别是在筛选栏中新建，以及新建卡片-选择卡片类型为筛选器。

• 筛选栏-新建筛选器。

• 页面-新建卡片-选择筛选器。

选择筛选器类型为“树状”，即可进入树状筛选器属性编辑弹窗。

2.2. 筛选器属性配置

设置树状筛选器时，首先选择来源数据集，再选择需要让消费者筛选的多级字段。

• 支持设置选择类型是单选还是多选，再选择一个适合的样式；

• 可选择筛选方式，同时支持设置筛选器的默认值。

图示：

如果需要再次编辑筛选器的属性，需要在筛选器卡片的工具栏中找到“编辑”功能，再次进入筛选器的属性配置弹窗。

2.3. 设置联动目标卡片

联动时需要选择目标卡片及对应筛选的字段/参数，设置后，筛选器的变化会联动改变关联卡片呈现的数据。

筛选方式为“不带路径”：关联时，仅需关联末级节点字段（参数）即可；

筛选方式为“带路径”：关联时，需要关联每级节点字段（参数）。

• 自动关联卡片：筛选器开启自动关联后，将自动关联有同名的字段的可视化卡片；自动关联的卡片可以手动点击取消关联；

• 应用至同数据集卡片：点击应用至同数据集卡片，即自动关联同一数据集下的其他卡片对应的字段，应用至同数据集的卡片可以手动点击取消关联。

如果需要再次编辑筛选器的联动关系，需要在筛选器卡片的工具栏中找到“联动”功能，再次进入筛选器的联动配置弹窗。

2.4. 使用筛选器

使用

用户在使用时，可选项上限为1000；可以模糊搜索选项、批量粘贴、查看已选

• 模糊搜索：大小写不敏感，但某些直连数据库语法不支持大小写不敏感；

• 批量粘贴：一键复制可选项后，可以根据名称自动匹配选项列表，减少点击步骤。

注意：
筛选方式为“带路径”时，粘贴的内容必须是多层级的完整信息，如果仅粘贴了一个字段的内容，则默认从叶节点开始识别。
举例：
省份-城市-区县的树状带路径筛选器，
此时需要输入某个区县的信息：应该输入xx省/xx市/xx县，这样才能匹配正确数据；
如果输入的是：xx县，则会用xx县去匹配省份字段的数据，这样无法匹配正确数据。

查看筛选效果

筛选器筛选后，会对每个联动卡片生效，卡片呈现出筛选器筛选后的数据；用户浏览卡片时，可以通过鼠标hover至卡片工具栏的“小漏斗”图标查看当前的筛选条件。

• 筛选方式为“带路径”：

• 筛选方式为“不带路径”：