适用场景:安装了「FineVis数据可视化」插件的用户,可参考本文了解 FineVis 的相关功能。
版本
报表服务器版本 | 插件版本 | 功能变动 |
---|---|---|
11.0.16 | V1.15.1 | FVS图表组件适配 API 接口 |
注:本文接口不支持 FVS 中 扩展图表 类型的图表组件。
duchamp.getWidgetByName
方法 | duchamp.getWidgetByName("widgetName") | 获取图表组件对象,获取后可以使用组件的方法和属 性 注:暂不支持获取表格中的图表 |
---|---|---|
参数 | widgetName | FVS 图表组件名称 |
返回值 | object | 当前图表组件对象 |
示例 | 示例:获取「柱形图组件」对象
| |
应用示例 | - | |
移动端 | 支持移动端 |
getSeries
方法 | getSeries() | 获取系列对象数组 |
---|---|---|
参数 | - | - |
返回值 | series[] | 当前图表组件系列数组 |
示例 | 示例:获取「柱形图组件」对象的系列数组
| |
应用示例 | - | |
移动端 | 支持移动端 |
series
方法 | series[seriesIndex] | 获取系列对象 |
---|---|---|
参数 | seriesIndex | 默认的图表对象有一个 series 属性,该对象存储的是图表内系列相关的数据信息,是一个对象数组。如果想要获得图表中某一个具体的系列对象,则需要指定对应的索引 seriesIndex,seriesIndex 从 0 开始计数 |
示例 | 示例:获取「柱形图组件」对象的第一个系列对象
注:写在一起时正确写法为 getSeries()[0] ,不支持 getSeries().series[0] | |
应用示例 | - | |
移动端 | 支持移动端 |
series 属性
属性 | 类型 | 说明 |
---|---|---|
points | Array | 当前系列的所有数据点 |
name | String | 当前系列的名字,跟图例显示的系列名一致 |
type | String | 当前系列的图表类型,目前包括的类型如下图所示: |
series.points
方法 | series.points[pointIndex] | 获取数据点对象 需在获取图表系列对象之后使用 |
---|---|---|
参数 | pointIndex | 每个 series 对象里面又有一个 points 的属性,也是一个对象数组,这个 points 数组里面存放的就是我们想要的 point 数据点对象。 如果需要获取某个具体的数据点对象,则需要指明该数据点的索引 pointIndex,pointIndex 从 0 开始计数 |
示例 | 示例:获取「柱形图组件」对象的第一个系列对象的第一个数据点
| |
移动端 | 支持移动端 |
points 属性
属性 | 类型 | 说明 |
---|---|---|
name | String | 对于区域地图来说,name 表示当前数据点的区域名,比如江苏省,南通市等等 |
seriesName | String | 当前数据点所在的系列名 |
category | String | 对于坐标轴图,表示数据点所在分类的名字 |
categroyArray | Array | 对于 多分类坐标轴图,表示数据点所在分类数组的名字 |
value | Number | 对于坐标轴图,表示数据点在值轴对应的数值 注:散点图的 value 对应「值」字段的数值 |
series | Object | 当前数据点所在的系列 |
setSeriesVisible
方法 | setSeriesVisible() | 图表显示部分系列 |
---|---|---|
参数 | seriesIndex[] | seriesIndex:number 表示一个图表中不同的系列,从 0 开始计数 |
返回值 | - | - |
示例 | 示例:显示柱形图组件的系列1和系列2
| |
应用示例 | - | |
移动端 | 支持移动端 |
sortChart
方法 | sortChart(sortType) | 图表排序接口 |
---|---|---|
参数 | sortType | sortType 参数表示排序规则,1 表示升序,-1 表示降序,不写参数则升序降序互相切换 |
返回值 | - | - |
示例 | 示例:
| |
应用示例 | - | |
移动端 | 支持移动端 |
openAutoTooltip
注:扩展图表类型仅支持特殊形状柱形图。
方法 | openAutoTooltip([delay, initPoints]) | 数据点提示轮播接口 |
---|---|---|
参数 | delay, initPoints | delay:数据点提示的切换时间间隔,默认为 3s initPoints:轮播数据点提示对应的数据点集合,默认为图表内所有数据 注:V2.4.0 及之后版本才支持使用 initPoints |
返回值 | - | - |
示例 | 示例1:
注:3000代表轮播时间间隔3秒,可自行调整 示例2:仅第一个系列所有数据点轮播提示
| |
应用示例 | ||
移动端 | 不支持移动端 |
setMapZoom
方法 | setMapZoom(mapZoom) | 设置地图缩放等级和中心点 |
---|---|---|
参数 | MapZoomProps = { zoomLevel: number | string; viewCenter: [number, number]; }; | zoomLevel:缩放等级,值区间一般在0-18。数值越大,层级越高,地图显示越细致,显示的经纬度范围越小 viewCenter:中心点,[经度,纬度] |
返回值 | - | - |
示例 | 示例:
| |
应用示例 | - | |
移动端 | 支持移动端 |
getZoom
方法 | getZoom() | 获取地图缩放层级 |
---|---|---|
参数 | - | - |
返回值 | number | 缩放等级,值区间一般在0-18。数值越大,层级越高,地图显示越细致,显示的经纬度范围越小 |
示例 | 示例:
| |
应用示例 | - | |
移动端 | 支持移动端 |
getCenter
方法 | getCenter() | 获取地图中心点 |
---|---|---|
参数 | - | - |
返回值 | [number, number] | 中心点,[经度,纬度] |
示例 | 示例:
| |
应用示例 | - | |
移动端 | 支持移动端 |
panTo
方法 | panTo(center) | 地图转移中心点 |
---|---|---|
参数 | center | center 中心点,[纬度,经度] 注:panTo 接口中「纬度」在前,「经度」在后 |
返回值 | - | - |
示例 | 示例:
| |
应用示例 | - | |
移动端 | 支持移动端 |
drillDown
方法 | drillDown(area) | 钻取地图向下钻取 |
---|---|---|
参数 | area | area 不是单纯的区域名,而是区域名下对应的一系列信息,可根据区域名获取到 area |
返回值 | - | - |
示例 | 示例:
| |
应用示例 | - | |
移动端 | 支持移动端 |
drillUp
方法 | drillUp(index) | 钻取地图向上钻取 |
---|---|---|
参数 | index | index:自然数,表示钻取层级,从0开始:0、1、2…… |
返回值 | - | - |
示例 | 示例:
| |
应用示例 | - | |
移动端 | 支持移动端 |
getLayerIndex
方法 | getLayerIndex() | 获取钻取地图当前钻取层级,获取的层级从0开始:0、1、2…… |
---|---|---|
参数 | - | - |
返回值 | number | 钻取地图当前钻取层级 |
示例 | 示例:
| |
应用示例 | ||
移动端 | 支持移动端 |
getLayerNames
方法 | getLayerNames() | 获取钻取目录名称,结果为数组,例如:["中国", "湖南省", "长沙市"] |
---|---|---|
参数 | - | - |
返回值 | string[] | 数组,例如:["中国", "湖南省", "长沙市"] |
示例 | 示例:
| |
应用示例 | ||
移动端 | 支持移动端 |