1. 概述
适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FineVis 的相关功能。
1.1 版本
| 报表服务器版本 | 插件版本 | 功能变更 |
|---|---|---|
| 11.0 | V1.x | V1.x 版本文档请参考：FVS组件交互属性历史版本 |
| 11.0.16 | V2.0.0 | 三维组件交互事件移动入口到 三维组件数据图层 中设置 |
| 11.0.22 | V2.10.0 | 交互点击事件界面优化，具体请参见第 3 章节 |
1.2 功能简介
本章将简单介绍 FVS 中组件交互的相关知识。
1.3 视频教程
2. 功能简介
2.1 功能入口
选中页面上的组件，点击配置栏的「交互」按钮，可设置组件的相关交互属性：交互事件、轮播设置、监控刷新。组件类型不同支持的事件也有所不同。
2.2 支持范围
不同类型的组件，支持配置的交互属性不完全相同。
1）表格组件和控件组件
| 组件 | 鼠标点击事件 | 初始化后事件 | 编辑结束事件 |
|---|---|---|---|
| 文本框控件、日期时间控件、下拉框控件、按钮组控件、下拉树控件、视图树控件 | 不支持 | 支持 | 支持 |
| 表格组件 | 不支持 | 支持 | 不支持 |
2）其他组件
| 组件 | 鼠标点击事件 | 轮播设置 | 监控刷新 |
|---|---|---|---|
| 场景地图 | 支持 | 支持 | 支持 |
| 电子智慧树图、模型智慧树图 | 支持 | 支持 但轮播无法关闭 | 支持 |
三维城市场景组件、三维自定义场景组件、标题组件 柱形图、堆积柱形图组件、百分比堆积柱形图、自定义柱形图、特殊图形柱形图 条形图、堆积条形图、百分比堆积条形图、自定义条形图 饼图、等弧度玫瑰图、不等弧度玫瑰图、多层饼图 折线图、堆积折线图、自定义折线图 面积图、堆积面积图、百分比堆积面积图、自定义面积图 雷达图、堆积雷达图 360度多指针仪表盘、180度多指针仪表盘 百分比圆环仪表盘、百分比刻度槽型仪表盘、试管型仪表盘 区域地图、点地图、流向地图、组合地图、热力地图 钻取区域地图、钻取点地图、自定义钻取地图 三维柱形地球、三维点地球 散点图、气泡图 矩形树图、词云图、力学气泡图、漏斗图 柱形图-折线图、柱形图-面积图、堆积柱形图-折线图、自定义组合图 甘特图、纵向框架图、横向框架图、发散框架图、箱形图 | 支持 | 不支持 | 支持 |
| 图片组件、查询控件 | 支持 | 不支持 | 不支持 |
| 轮播饼图、轮播夜光仪表盘、水球图、像素点图 轮播闪烁指标卡、轮播电子指标卡、轮播目录齿轮图 轮播三维组合地图、轮播GIS点地图 | 不支持 | 支持 轮播无法关闭 | 支持 |
| 轮播条形图 | 不支持 | 部分支持 | 支持 |
| 轮播器组件 | 不支持 | 支持 | 不支持 |
弧形柱形图、粒子计数器、三维流向地球 富文本组件、网页框组件 | 不支持 | 不支持 | 支持 |
| 时间齿轮、本地视频组件、本地监控组件 | 不支持 | 不支持 | 不支持 |
3. 功能详情
3.1 交互事件
根据组件类型，支持的交互事件有所不同。交互事件分为「初始化后」、「编辑结束」、「鼠标点击」事件。
注：V2.10.0 及之后版本，交互事件配置方式变更为事件配置、事件下的动作配置。
3.1.1 初始化后事件
「初始化后」事件为 V1.5.0 版本插件新增的事件类型，仅表格组件和控件组件支持添加「初始化后」事件。
选择组件，点击「交互>交互事件>添加事件>初始化后事件」，在弹出页面中可添加 JaveScript 执行动作。
注：仅支持添加一个初始化后事件，支持在同一个初始化事件下添加多个 JaveScript 执行动作。
3.1.2 编辑结束事件
「编辑结束」事件为 V1.5.0 版本插件新增的事件类型，仅控件组件支持「编辑结束」事件。
选择组件，点击「交互>交互事件>添加事件>编辑结束事件」，在弹出页面中可添加 JaveScript 执行动作。
注：仅支持添加一个编辑结束事件，支持在同一个编辑结束事件下添加多个 JaveScript 执行动作。
3.1.3 鼠标点击事件
选择组件，点击「交互>交互事件>添加事件>鼠标点击」，在弹出页面中添加执行动作。
支持添加「组件联动」、「网页链接/弹出框」、「JavaScript」、「分页跳转」、「显示/隐藏」、「三维漫游动画」、「三维模型动画」、「三维自定义视角」
鼠标点击事件的注意事项如下表所示：
| 注意事项 | 图示 |
|---|---|
若组件类型为「场景地图、组合图、钻取区域地图、钻取点地图、自定义钻取地图」等存在多层数据的组件，用户可分别为不同对象添加事件类型。 | 例如钻取地图可选择给「图形」或「钻取目录」添加事件。 如下图所示：
|
注：V1.16.0 及之后版本，支持添加多个同类型执行动作。 | |
| |
注：不同事件不支持同名、同一事件下的的不同执行动作不支持同名。 | |
同一组件添加多个事件时，需选择触发事件。 注：V2.10.0 之前版本，「网页链接、弹出框、分页跳转」三种事件类型需选择触发，其余事件无需选择直接触发。 | |
同一个事件内添加了多个执行动作时，同时触发多个执行动作。 | - |
3.2 轮播设置
选择组件，点击「交互>轮播设置」，支持自定义轮播间隔，默认为 6000 毫秒。
3.3 监控刷新
选择组件，点击「交互>监控刷新」，可根据设置的时间定时刷新组件。
「开启监控刷新」默认不勾选，勾选后支持自定义刷新间隔，默认为 6 秒。如下图所示：
4. 交互示例汇总
FVS 支持的所有交互属性如下表所示：
| 交互属性 | 简介 | 示例 | |
|---|---|---|---|
| 鼠标点击事件 | 组件联动 | 添加组件联动后，可将参数传递给模板组件，实现更多数据展示效果 | FVS点击联动组件 |
| 网页链接/弹出框 | 添加网页链接/弹出框事件，可触发对应元素的打开网页链接或弹出框内容，实现丰富的个性化内容 | ||
| JavaScript | 实验室功能 添加JavaScript脚本后可执行所设置的JavaScript脚本，实现丰富的个性化效果 | FVS支持的JS接口场景 | |
| 分页跳转 | 添加分页跳转后可跳转到目标页面 | FVS分页跳转事件 | |
| 显示/隐藏 | 添加后可控制目标对象的显示或隐藏 | FVS显示隐藏组件事件 | |
| 三维漫游动画 | 三维城市组件和自定义模型组件设置漫游路径后，可设置播放漫游动画效果 | 三维场景漫游路径动画 | |
| 三维模型动画 | 添加三维组件动画后可触发对应三维城市组件的动画效果 | 三维场景模型动画 | |
| 三维自定义视角 | 添加后支持用户选择三维场景内要切换的视角信息 | FVS点击切换三维自定义视角 | |
| 轮播设置 | 组件联动 | 开启自动轮播后，可添加组件联动，按照轮播效果将参数传递给模板组件，实现更多数据展示效果 | - |
| 三维模型动画 | 开启自动轮播后，可添加三维城市动画，触发对应三维城市组件的动画效果 | - | |
| JavaScript | 实验室功能 开启自动轮播后，可添加JavaScript脚本，执行所设置的JavaScript脚本，实现丰富的个性化效果 | FVS支持的JS接口场景 | |
| 监控刷新 | - | 可根据设置的时间定期刷新 | - |
| 初始化后事件（V1.5.0 新增） | 可设置表格/控件初始化后 JavaScript 事件 | FVS支持的JS接口场景 | |
| 加载结束事件（V1.5.0 新增） | 可设置控件加载结束时的 JavaScript 事件 | FVS支持的JS接口场景 | |
