FVS基础图表实现数据点提示轮播

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

1.1 版本

1.2 预期效果

FVS 中，支持普通图表使用 openAutoTooltip 接口实现开启自动数据点提示轮播功能。效果如下图所示：

注：扩展图表 类型仅支持特殊形状柱形图，其余扩展图表不支持。

1.3 接口说明

使用之前先获取需要操作的 FVS图表对象 ，然后调用该图表对象的 openAutoTooltip 方法即可开启图表数据点提示自动轮播的功能。

duchamp.getWidgetByName("图表组件").openAutoTooltip(delay, initPoints]);

若要实现模板初始化时就开启提示点轮播，可将代码写在「页面加载结束事件」中，具体示例请参见示例一。

JavaScript 代码写法如下：

duchamp.on("storychange", (current) => {
setTimeout(() => {
  if (current === "页面1") {
    duchamp.getWidgetByName("图表组件").openAutoTooltip(3000);
  }
 }, 3000)
});

若要获取图表的部分系列数据，可参考如下代码：

注：V2.4.0 及之后版本才能使用 initPoints 参数。

duchamp.on("storychange", (current) => {
setTimeout(() => {  
    if (current === "页面1") {
        var vanchart=duchamp.getWidgetByName("图表组件");
        vanchart.openAutoTooltip(1000,vanchart.getSeries()[0].points); //数据点取图表组件第一个系列所有数据点
    } 
  }, 3000)
});

V3.3.0 版本，新增 stopAutoTooltip 和 moveOnAutoTooltip 接口，用于暂停和继续播放数据点提示自动轮播。用法与 openAutoTooltip 一致，详情参见示例二。

2.1 新建模板

点击设计器左上角「文件>新建可视化看板」，创建一张空白看板，可自定义模板名称和尺寸。如下图所示：

2.2 准备数据

新建两个数据库查询：

1）ds1 输入 SQL 查询语句：SELECT * FROM 销量 。用于绑定柱形图数据。

2）ds2 输入 SQL 查询语句：SELECT * FROM 地图 。用于绑定地图数据。

2.3 添加柱形图

点击组件区「图表>柱形图」，将其添加到页面中，并绑定数据如下图所示：

2）选中柱形图，点击右侧配置面板「组件」，设置组件名称为「柱形图」。如下图所示：

2.4 添加地图

1）点击画布下方的「点击新建页面」，新建「页面2」。如下图所示：

2）点击组件区「图表>区域地图」，将其添加到页面中，并绑定数据如下图所示：

3）选中地图，点击右侧配置面板「组件」，设置组件名称为「地图」。如下图所示：

2.5 添加页面加载结束事件

点击「模板>页面加载结束事件」，输入 JavaScript 代码如下：

duchamp.on("storychange", (current) => {
setTimeout(() => {
  if (current === "页面1") {
    duchamp.getWidgetByName("柱形图").openAutoTooltip();
  }
  if (current === "页面2") {
    duchamp.getWidgetByName("地图").openAutoTooltip();
  }
 }, 3000)
});

如下图所示：

2.6 效果预览

点击右上角「保存」，再点击「预览」。效果如下图所示：

3.1 新建模板

点击设计器左上角「文件>新建可视化看板」，创建一张空白看板，可自定义模板名称和尺寸。如下图所示：

3.2 准备数据

新建数据库查询：ds1 输入 SQL 查询语句：SELECT * FROM 销量 。

3.3 添加组件

1）添加柱形图

点击组件区「图表>柱形图」，将其添加到页面中。具体设置与 2.3 节一致。

2）添加标题组件

点击组件区「其他>标题」，添加三个标题组件，用于设置点击事件。

分别设置标题内容为：开启数据点自动轮播、暂停数据点自动轮播 和 继续播放数据点自动轮播 。

3.4 设置点击事件

3.4.1 开启数据点自动轮播

选中「开启数据点自动轮播」标题组件，点击「交互>鼠标点击>JavaScript」。输入 JavaScript 代码如下：

duchamp.getWidgetByName("柱形图").openAutoTooltip(1000)

步骤如下图所示：

3.4.2 暂停数据点自动轮播

选中「暂停数据点自动轮播」标题组件，点击「交互>鼠标点击>JavaScript」。输入 JavaScript 代码如下：

duchamp.getWidgetByName("柱形图").stopAutoTooltip()

3.4.3 继续数据点自动轮播

选中「继续播放数据点自动轮播」标题组件，点击「交互>鼠标点击>JavaScript」。输入 JavaScript 代码如下：

duchamp.getWidgetByName("柱形图").moveOnAutoTooltip()

3.5 效果预览

点击下载模板：

示例一：FVS中基础图表实现数据提示点轮播.fvs

示例二：FVS中控制数据提示点轮播.fvs