1. 概述
适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FineVis 的相关功能。
1.1 版本
| 报表服务器版本 | 插件版本 | 功能变动 |
|---|---|---|
| 11.0.6 | V1.x | V1.x 版本文档请参考：FVS控件组件历史版本 |
| 11.0.16 | V2.0.1 | 控件组件新增样式设置，可实现更丰富的样式效果，详情参见 3.5 节 |
| 11.0.22 | V2.8.0 | 控件名称与参数分离，新增绑定参数逻辑，详情参见 3.1 节 |
| 11.0.22 | V2.10.0 |
|
1.2 应用场景
在报表的具体应用中，经常使用「控件」来实现不同的功能，在普通报表、决策报表中应用广泛。
在 FVS 中，控件是作为组件直接添加到分页中使用的。同样支持组件属性：FVS组件动画 、FVS组件样式属性 。
本文将主要介绍「控件」在 FVS 中的其他通用属性。
1.3 视频教程
2. 控件类型
| 控件分类 | 控件类型 | 简介 |
|---|---|---|
| 输入框 | FVS文本框控件 | 模板预览时可在文本框中手动输入值，通过参数联动其他组件 |
| 日期 | FVS日期时间控件 | 模板预览时可选择日期时间，通过参数联动其他组件 |
| 列表 | FVS下拉框控件 | 模板预览时可下拉选择选项，支持多选，通过参数联动其他组件 |
| FVS按钮组控件 | 模板预览时可单选/多选按钮选项，通过参数联动其他组件 | |
| 树 | FVS下拉树控件 | 在模板预览时，下拉可展现具有多层树状结构的数据，并通过参数联动其他组件 |
| FVS视图树控件 | 模板预览时，可通过视图树控件展现具有多层树状结构的数据，并通过参数联动其他组件 | |
| 其他 | FVS查询按钮 | 使用查询按钮关联控件，可实现点击查询按钮，再触发控件查询 |
3. 功能说明
3.1 绑定参数
1）当需要与其他组件实现参数联动时，需要将「内容>绑定参数」的值设置为与参数名相同。
支持已有参数的绑定，也可以直接输入新值以创建新的参数。
例如参数「area」表示地区，那么「绑定参数」的值也需要设置为「area」。如下图所示：
2）同一分页中，不支持绑定同一参数的控件；不同分页中，支持绑定同一参数。
注1：V2.8.0 之前版本，组件名称设置位于「内容>名称」，用于与参数绑定。V2.8.0 及之后版本，组件名称在「组件>组件属性>名称」中设置，仅用于设置组件名称。
注2：建议根据绑定参数自定义组件名称，便于后续查找。
3.2 参数查询逻辑
1）在 FVS 中，控件在修改值后自动触发查询，与控件绑定参数相关的组件均会刷新，且对整个模板所有分页生效。
例如 页面1、页面2 均存在图表引用了 area 参数，那么在 页面1 中改变下拉框控件参数值，页面1 和 页面2 中图表均随之变化。
如下图所示：
2）不同分页中，若存在「绑定参数」相同的控件
在模板预览时，任意分页上控件值改变，其他分页的绑定相同参数的控件也随之变化。
在模板编辑界面中，不同分页中绑定相同参数的控件默认值会相互覆盖，以最后操作的控件默认值为准。
例如：
页面1、页面2 均有一个文本框控件，「绑定参数」均设置为「area」。给 页面1 的文本框控件设置默认值为「华东」，页面2 中的文本框控件默认值也显示为「华东」；在 页面2 将控件默认值修改为「华北」，页面1 中控件默认值也将变为「华北」。
预览时同理。
3.3 控件隐藏或显示
1）控件的显示或隐藏可以通过「组件图层」实现。如下图所示：
2）控件的显示或隐藏也可以通过 JavaScript 或 「显示/隐藏」点击事件，结合组件名称实现。
3.4 控件事件
FVS 控件目前支持的事件包括：初始化后事件、加载结束事件。
| 点击事件 | 初始化后事件 | 编辑结束事件 | 组件 |
|---|---|---|---|
| 不支持 | 支持 | 支持 | 文本框控件、日期时间控件、下拉框控件、下拉复选框控件、按钮组控件 |
FVS 支持以下控件接口，更多内容可参考文档：控件通用 。
用法参考决策报表 body 中控件的用法，但需要将获取对象的接口 _g() 换成 duchamp 。
| 接口 | 说明 | 示例 |
|---|---|---|
| getValue | 获取控件的实际值 | duchamp.getWidgetByName("控件名称").getValue(); |
| getText | 获取控件的显示值 | duchamp.getWidgetByName("控件名称").getText(); |
| setValue | 设置控件的值 | duchamp.getWidgetByName("控件名称").setValue('文本'); |
| setVisible | 设置控件可见/不可见 | duchamp.getWidgetByName("控件名称").setVisible(false); |
| isVisible | 返回控件状态是可见/不可见 返回 true 表示可见 返回 false 表示不可见 | duchamp.getWidgetByName("控件名称").isVisible(); |
| setEnable | 设置控件可用/不可用 | duchamp.getWidgetByName("控件名称").setEnable(false); |
| isEnabled | 返回控件状态是可用/不可用 返回 true 表示可用 返回 false 表示不可用 | duchamp.getWidgetByName("控件名称").isEnabled(); |
| reset | 重置控件、清空控件的内容 | duchamp.getWidgetByName("控件名称").reset(); |
| setWaterMark | 添加水印文字（仅支持有输入框的控件） | duchamp.getWidgetByName("控件名称").setWaterMark('我是水印'); |
更多内容请参考文档：FVS支持的JS接口场景 。
3.5 控件样式
3.5.1 单独控件样式
V2.0.1 版本所有控件新增「内容样式」，不同的控件内容样式也有些许不同，可到具体文档查看详情。
最基础的字符样式设置所有控件均支持，例如下图所示：
例如按钮组控件，还支持设置样式模板，如下图所示：
另外 V2.0.1 版本中，组件边框背景支持了「边框线」设置，可设置边框线类型、粗细及颜色。如下图所示：
3.5.2 模板整体控件样式
V2.6.1 及之后版本，FVS控件样式可通过 FVS模板样式 设置模板统一的控件文字、图标、高亮、边框线等样式。
V2.6.1 之前版本，在顶部菜单栏「模板>模板主题」中，仅支持选择几种类型主题的固定样式。如下图所示：
