筛选组件
页面内用来对图表进行筛选的组件为筛选组件。
一个页面内具有多个筛选器时,所有筛选器筛选内容之间的关系为「且」,即:图表会受到相关联的所有筛选器的同时影响。
筛选组件的添加过程,可见组件的添加方法。
配置筛选器
筛选组件的配置区域在页面画布区域的右侧。点击选中筛选组件后,该组件对应的配置内容自动展开。
筛选组件的配置内容包括数据配置和样式配置。配置过程可见具体筛选器类型。
工作表选择
开始进行数据配置时,需要先选定筛选组件要用到的工作表。
支持使用状态为「可用」的工作表。
并可在后续编辑中,修改选定的工作表。工作表修改后,已完成的数据配置会被置空。
选定工作表后,配置区域可见该工作表内所有可用于图表配置的字段。
选定的工作表,会作为筛选器候选项的计算依据,并作为与图表关联的依据。
图表关联
筛选器作用范围:
- 筛选器仅作用于同页面内的图表组件
- 可以通过编辑「图表关联」,修改筛选器作用的图表范围
- 可以通过增加「跨工作表关联」,关联到其他工作表对应的图表
图表关联会显示配置的工作表对应的图表,并默认勾选创建筛选器时已存在的图表(后续创建图表不会默认勾选,需手动勾选)。
如需要通过该筛选器控制其他工作表对应的图表,需要配置跨工作表关联。
配置跨工作表关联时,需要选择工作表、关联字段两个选项。字段部分与筛选器类型相关,下拉筛选器要求关联的字段是文本,日期筛选器要求关联的字段是时间或文本。
配置完成后,该工作表对应的图表会出现在图表关联设置区,可勾选具体的图表,可整体勾选对应的所有的图表。
筛选器发生筛选变化时,通过配置的关联字段,图表的数据使用筛选后的数据计算。
筛选器类型
支持配置的筛选器为:下拉筛选器、日期筛选器。
下拉筛选器
下拉筛选器为下拉列表选择所需选项的筛选器,支持基于文本或数值类型的字段进行筛选。
在未进行单个选项选择时,默认为「不限」,即不对该筛选器进行选择的情景。
数据配置
下拉筛选器的数据配置部分,配置内容为:
-
字段:为筛选器中被筛选的字段,仅支持配置一个;
- 仅能配置文本或数值类型的字段;
- 候选项是通过工作表内该字段对应数据计算出的
-
默认选项:在选择完字段后,可通过输入来配置筛选器的默认选项,最多可配置 10 个;
- 非必配内容,不配置的情况下,默认为「不限」
- 查看者每次打开仪表盘,筛选器都会按「默认选项」进行筛选,图表会按筛选后结果展示
-
指标:配置的指标仅用来计算候选项及候选项的顺序;
- 指标的配置过程与图表组件的指标一致;
- 下拉筛选器用于计算的指标仅支持配置一个
-
过滤:配置的过滤条件会用于候选项的计算,被过滤条件过滤掉的数据将不会出现在候选项列表中;
- 过滤配置的过程与图表组件一致;
-
排序:可添加字段、指标到排序中,计算结果会按照排序内容进行排序,最终决定候选项的展示顺序。
样式配置
- 显示标题:支持给筛选器添加标题,方便使用者辨别筛选器内容
- 类型配置:筛选器支持配置为单选或多选,支持展示或隐藏搜索框
- 外观:可配置筛选组件卡片的底色、边框颜色、边框粗细
日期筛选器
日期筛选器为选择日期段的筛选器,不支持选择具体时分秒。
在未进行日期选择时,默认为「不限」,即不对该筛选器进行选择的情景。
日期筛选器内可选择动态时间和静态时间。
数据配置
日期筛选器的数据配置部分,配置内容为:
-
字段:为筛选器中被筛选的字段,仅支持配置一个;
- 支持配置时间、日期类型的字段
- 支持配置文本类型的字段,但需要额外指定日期格式,请根据实际值按照 SimpleDateFormat 的格式填入
附部分常见场景的文本类型日期分区的配置方式供参考
日期分区值的样例 填入的日期格式 2025-09-01 yyyy-MM-dd 2025-09 yyyy-MM 20250901 yyyyMMdd 2025-36 yyyy-ww
⚠️ 需要注意的是,编辑状态下无法兼容所有日期格式的处理,可能无效或不符合预期,请进入预览确认效果
- 时间范围:为日期筛选器的默认筛选范围,可选择一个静态或动态日期范围;
- 每次打开仪表盘,该日期筛选器会按照配置的日期范围进行筛选后展示;
样式配置
- 显示标题:支持给筛选器添加标题,方便使用者辨别筛选器内容
- 外观:可配置筛选组件卡片的底色、边框颜色、边框粗细

