1. 概述
适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FineVis 的相关功能。
1.1 版本
| 报表服务器版本 | 插件版本 | 功能变动 |
|---|---|---|
| 11.0.22 | V2.3.1 | 新增查询按钮 |
1.2 应用场景
FVS 模板使用控件查询时，修改控件值后会自动触发查询。使用查询按钮关联控件，可实现点击查询按钮，再触发控件查询。
效果如下图所示：
注：本文仅为大家介绍查询组件特有功能，其他属性不赘述。
组件交互请参见：FVS组件交互属性 。
组件动画请参见：FVS组件动画 。
组件样式请参见：FVS组件样式属性 。
2. 功能介绍
2.1 添加查询组件
每个分页，仅支持添加一个查询按钮。未添加时，在组件区「控件」类型中，可点击或拖拽「查询」组件添加到画布。
添加查询按钮后，当前分页组件区查询组件置灰，悬浮组件提示「每页只能添加1个查询组件」。如下图所示：
2.2 查询组件内容
查询组件可设置内容如下图所示：
各设置项的详细介绍如下表所示：
| 设置项 | 详细介绍 |
|---|---|
| 按钮内容 | 查询组件显示的文字内容，仅支持输入文本，默认为「查询」 |
| 关联控件 | 设置哪些控件被「查询」按钮控制，不再自动查询 列表中包含当前页所有控件，默认全选，新增的控件自动被选中 |
| 内容样式 | 字符样式：支持对查询按钮中显示的字符进行样式设置，例如字体、字号、颜色等 注1：修改字符颜色后，再设置 FVS模板主题 ，字符颜色会跟随主题变化，需重新设置 注2：组件填充颜色需在组件样式中设置
|
3. 查询逻辑说明
1）查询按钮仅控制当前页被关联的控件，未被关联的控件仍自动触发查询；预览初始化时，根据控件默认值自动查询。
例如当前页面有两个 下拉框控件 ，分别表示参数 area 和 product ，两个 标题组件 使用公式分别展示两个参数。
查询按钮的关联控件列表中，仅选中 area 下拉框控件。如下图所示：
预览效果如下图所示，area 参数控件在选择值后需点击「查询」才能联动标题组件，product 参数控件选择值后直接联动标题组件。
2）有多个分页时，不含查询按钮的页面，控件自动查询时同样能触发有查询按钮页面的控件组件联动，即仍然遵循绑定相同参数的控件分页间联动逻辑。
例如 页面1 和 页面2 都存在「绑定参数」为 area 的控件，且都存在引用了 area 参数的柱形图。页面1 中添加了查询按钮并关联了 area 控件，页面2 不添加查询按钮。
预览时，页面1 area 参数控件选择值后，需点击查询按钮，页面1 和 页面2 才能联动变化；页面2 area 参数控件选择值后，页面1 和 页面2 均直接联动变化。
3）若控件之间存在联动，而控件均被查询按钮关联，那么控件之间的联动仍然生效。
例如已有一个下拉框控件的「绑定参数」为 area ，再添加一个文本框控件，不设置绑定参数，设置其默认值为公式 =$area 。如下图所示：
当查询按钮关联控件全选时，area 下拉框选择值后，直接联动文本框控件。
当查询按钮关联控件仅选择 area 下拉框控件时，需点击查询，才能联动文本框控件。
4. 模板下载
点击下载模板：FVS查询按钮示例.fvs
上一篇：树控件构建方式
