适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FineVis 的相关功能。

1.1 版本

1.2 应用场景

在报表的具体应用中，经常使用「控件」来实现不同的功能，在普通报表、决策报表中应用广泛。

在 FVS 中，控件是作为组件直接添加到分页中使用的。同样支持组件属性：FVS组件动画 、FVS组件样式属性 。

本文将主要介绍「控件」在 FVS 中的其他通用属性。

1.3 视频教程

3.1 控件名称

1）控件的名称用于绑定参数，所以当需要与其他组件实现参数联动时，需将控件名称设置为与参数相同。

例如用参数「area」表示地区，那么控件名称也需要设置为「area」。

2）控件名称不在「组件」配置面板中设置，而在「内容」配置面板中设置。如下图所示：

3）同一分页中，不支持同名控件；不同分页中，支持同名控件，表示相同的参数。

3.2 控件隐藏或显示

控件的显示或隐藏统一通过「组件图层」实现。如下图所示：

3.3 控件查询逻辑

1）在 FVS 中，控件在修改值后自动触发查询，与控件名参数相关的组件均会刷新，且对整个模板所有分页生效。

例如 页面1、页面2 均存在图表引用了 area 参数，那么在 页面1 中改变下拉框控件参数值，页面1 和 页面2 中图表均随之变化。

如下图所示：

2）不同分页中，若存在同名控件，那么视为同一个参数。

在模板预览时，任意分页上控件值改变，其他分页的同名控件也随之变化。

在模板编辑界面中，不同分页中同名控件的默认值会相互覆盖，以最后操作的控件默认值为准。

例如：

页面1、页面2 均有一个文本框控件，控件名称均设置为「area」。给 页面1 的文本框控件设置默认值为「华东」，页面2 中的文本框控件默认值也显示为「华东」；在 页面2 将控件默认值修改为「华北」，页面1 中控件默认值也将变为「华北」。

预览时同理。

3.4 控件事件

FVS 控件目前支持的事件包括：初始化后事件、加载结束事件、点击事件。

FVS 支持以下控件接口，更多内容可参考文档：控件通用 。

用法参考决策报表 body 中控件的用法，但需要将获取对象的接口 _g() 换成 duchamp 。

更多内容请参考文档：FVS支持的JS接口场景 。

3.5 控件样式

3.5.1 单独控件样式

V2.0.1 版本所有控件新增「内容样式」，不同的控件内容样式也有些许不同，可到具体文档查看详情。

最基础的字符样式设置所有控件均支持，例如下图所示：

例如单选按钮组控件，还支持设置样式模板，如下图所示：

另外 V2.0.1 版本中，组件边框背景支持了「边框线」设置，可设置边框线类型、粗细及颜色。如下图所示：

3.5.2 模板整体控件样式

在 FVS 模板中，点击顶部菜单栏「模板>模板主题」，可设置控件组件样式，对当前模板中所有控件生效。

且若控件修改了「内容样式」，在模板主题中设置了控件组件样式后，控件字符颜色会跟随主题变化，需再次设置。因此建议先设置模板主题，再单独修改控件内容样式。

详细介绍请参见文档：FVS模板主题 。