历史版本17 :FVS基础图表实现数据点提示轮播 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

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

1.1 版本

报表服务器版本
插件版本功能变动
11.0V1.0.0
-
11.0V3.3.0新增 stopAutoTooltip 和 moveOnAutoTooltip 接口,具体参见 1.3 节

1.2 预期效果

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

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

1656935737709641.gif

1.3 接口说明

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

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

参数
含义
delay数据点提示的切换时间间隔,默认为 3000ms ,即 3s 
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 一致,详情参见示例二。

接口
含义
stopAutoTooltip停止自动轮循播放数据点提示
moveOnAutoTooltip继续从停止位置播放数据点提示轮播

2. 示例一编辑

2.1 新建模板

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

1.png

2.2 准备数据

新建两个数据库查询:

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

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

2.3 添加柱形图

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

36.png

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

37.png

2.4 添加地图

1)点击画布下方的「点击新建页面」,新建「页面2」。如下图所示:

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

39.png

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

40.png

2.5 添加页面加载结束事件

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

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

如下图所示:

41.png

2.6 效果预览

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

82AE22F8-C7F6-4A33-892A-CAA73439776C.GIF

3. 示例二编辑

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 效果预览

11.gif

4. 模板下载编辑