跳到主要内容

筛选组件

最近更新 2026/10/03

页面内用来对图表进行筛选的组件为筛选组件。

一个页面内具有多个筛选器时,所有筛选器筛选内容之间的关系为「且」,即:图表会受到相关联的所有筛选器的同时影响。

筛选组件的添加过程,可见组件的添加方法。

配置筛选器​

筛选组件的配置区域在页面画布区域的右侧。点击选中筛选组件后,该组件对应的配置内容自动展开。

筛选组件的配置内容包括数据配置和样式配置。配置过程可见具体筛选器类型。

工作表选择​

开始进行数据配置时,需要先选定筛选组件要用到的工作表。

支持使用状态为「可用」的工作表。

并可在后续编辑中,修改选定的工作表。工作表修改后,已完成的数据配置会被置空。

选定工作表后,配置区域可见该工作表内所有可用于图表配置的字段。

选定的工作表,会作为筛选器候选项的计算依据,并作为与图表关联的依据。

图表关联​

筛选器作用范围:

  • 筛选器仅作用于同页面内的图表组件
  • 可以通过编辑「图表关联」,修改筛选器作用的图表范围
  • 可以通过增加「跨工作表关联」,关联到其他工作表对应的图表

图表关联会显示配置的工作表对应的图表,并默认勾选创建筛选器时已存在的图表(后续创建图表不会默认勾选,需手动勾选)。

如需要通过该筛选器控制其他工作表对应的图表,需要配置跨工作表关联。

配置跨工作表关联时,需要选择工作表、关联字段两个选项。字段部分与筛选器类型相关,下拉筛选器要求关联的字段是文本,日期筛选器要求关联的字段是时间或文本。

配置完成后,该工作表对应的图表会出现在图表关联设置区,可勾选具体的图表,可整体勾选对应的所有的图表。

筛选器发生筛选变化时,通过配置的关联字段,图表的数据使用筛选后的数据计算。

筛选器类型​

支持配置的筛选器为:下拉筛选器、日期筛选器。

下拉筛选器为下拉列表选择所需选项的筛选器,支持基于文本或数值类型的字段进行筛选。

在未进行单个选项选择时,默认为「不限」,即不对该筛选器进行选择的情景。

下拉筛选器的数据配置部分,配置内容为:

  • 字段:为筛选器中被筛选的字段,仅支持配置一个;

    • 仅能配置文本或数值类型的字段;
    • 候选项是通过工作表内该字段对应数据计算出的
  • 默认选项:在选择完字段后,可通过输入来配置筛选器的默认选项,最多可配置 10 个;

    • 非必配内容,不配置的情况下,默认为「不限」
    • 查看者每次打开仪表盘,筛选器都会按「默认选项」进行筛选,图表会按筛选后结果展示
  • 指标:配置的指标仅用来计算候选项及候选项的顺序;

    • 指标的配置过程与图表组件的指标一致;
    • 下拉筛选器用于计算的指标仅支持配置一个
  • 过滤:配置的过滤条件会用于候选项的计算,被过滤条件过滤掉的数据将不会出现在候选项列表中;

  • 排序:可添加字段、指标到排序中,计算结果会按照排序内容进行排序,最终决定候选项的展示顺序。

  • 显示标题:支持给筛选器添加标题,方便使用者辨别筛选器内容
  • 类型配置:筛选器支持配置为单选或多选,支持展示或隐藏搜索框
  • 外观:可配置筛选组件卡片的底色、边框颜色、边框粗细

日期筛选器​

日期筛选器为选择日期段的筛选器,不支持选择具体时分秒。

在未进行日期选择时,默认为「不限」,即不对该筛选器进行选择的情景。

日期筛选器内可选择动态时间和静态时间。

数据配置​

日期筛选器的数据配置部分,配置内容为:

  • 字段:为筛选器中被筛选的字段,仅支持配置一个;

    • 支持配置时间、日期类型的字段
    • 支持配置文本类型的字段,但需要额外指定日期格式,请根据实际值按照 SimpleDateFormat 的格式填入

    附部分常见场景的文本类型日期分区的配置方式供参考

    日期分区值的样例填入的日期格式
    2025-09-01yyyy-MM-dd
    2025-09yyyy-MM
    20250901yyyyMMdd
    2025-36yyyy-ww

⚠️ 需要注意的是,编辑状态下无法兼容所有日期格式的处理,可能无效或不符合预期,请进入预览确认效果

  • 时间范围:为日期筛选器的默认筛选范围,可选择一个静态或动态日期范围;
    • 每次打开仪表盘,该日期筛选器会按照配置的日期范围进行筛选后展示;

样式配置​

  • 显示标题:支持给筛选器添加标题,方便使用者辨别筛选器内容
  • 外观:可配置筛选组件卡片的底色、边框颜色、边框粗细
这篇文档对你有帮助吗?