1. 概述
1.1 应用场景
在仪表板分析过程中，默认情况下筛选器在选择值后会立即触发数据查询。 但当仪表板存在多个筛选器且数据量较大时，频繁的自动查询会产生性能负担并干扰分析。此外，在完成一系列复杂筛选后，用户往往需要快速恢复到初始状态。本产品提供「查询」与「重置」组件来解决上述问题。
1.2 功能介绍
通过在仪表板中添加按钮类型筛选器，可以实现以下核心功能：
查询按钮： 变即时触发为手动触发。用户在设置完所有筛选条件后，点击该按钮才统一执行数据检索。
重置按钮： 一键将指定的筛选器恢复至「模板保存时的默认状态」（而非简单的清空值）。
2. 操作步骤
2.1 添加查询和重置按钮
1）打开一张仪表板，进入编辑页面。
2）在顶部组件栏点击「筛选器」，将「查询、重置」按钮添加到当前仪表板。如下图所示：
注：每个分页仅能添加 1 个查询/重置组件。
2.2 配置控制范围
配置「查询/重置」按钮的控制范围。
1）选中「查询」按钮，在右侧面板「属性>控制范围」中，勾选查询组件作用的筛选器。如下图所示:
注：默认勾选当前分页下的所有筛选器
2）同样的设置「重置」按钮的控制范围，如下图所示：
2.3 查询组件内容
查询组件可设置显示文字、控制范围等，各设置项说明见下表：
| 设置项 | 详细介绍 |
|---|---|
| 按钮文本 | 查询组件显示的文字内容，仅支持输入文本，默认为「查询」 |
| 控制范围 | 设置哪些筛选器被「查询」按钮控制，不再自动查询 默认全选当前页的所有筛选器，后续新增的筛选器也将自动被选中 |
| 文本样式 | 文本样式：支持对查询按钮中显示的文本进行样式设置，例如字体、字号、颜色等 注：组件填充颜色需在组件样式中设置 |
3. 逻辑说明
3.1 查询逻辑
查询按钮仅控制在「控制范围」勾选的筛选器，未被勾选的筛选器仍自动触发查询。
若筛选器之间存在联动且均被查询按钮关联，那么筛选器之间的联动仍会即时生效，但图表数据的更新需等待点击查询。
3.2 重置逻辑
点击按钮后，筛选器将恢复到保存仪表板时预设的「默认值」。若筛选器未设置默认值，则表现为清空。
移动端查询面板中的原「清空」按钮已统一升级为「重置」逻辑，确保跨端体验的一致性。
4. 效果查看
1）在仪表板中修改「年份」、「省份」等多个筛选器的选项，此时下方的图表组件不会立即触发查询，保持原有状态。
2）点击「查询」按钮，图表同步检索并展示最新的筛选结果。
3）点击「重置」按钮，「年份」、「省份」等筛选器恢复为默认筛选值。
上一篇：数值范围
