版本
| 版本 | 功能变更 |
|---|---|
| 11.0.3 | 新增一个获取当前展示图表 chartIndex 的接口 getCurrentChartIndex() |
| 11.0 | - |
Chart.WebUtils.getChart
| 方法 | Chart.WebUtils.getChart(chartID) | 获取图表块对象 |
|---|---|---|
| 参数 | chartID | chartID 为字符串类型，表示当前图表所在图表块的唯一标识 ID，在 JS 中书写时需区分大小写，与实际组件名称保持完全一致。 |
| 示例 | 示例1：获取单元格中插入的图表，chartID 为图表所在单元格，如：A1 示例2：获取悬浮元素图表，chartID 为悬浮元素的名称，选中悬浮元素，单击鼠标右键「设置悬浮名称」可查看或修改悬浮元素名称 示例3：获取决策报表中的图表块，chartID 为组件名称 示例4：获取决策报表的报表块中单元格图表 | |
| 移动端 | 支持 | |
| 注意事项 | 1）该接口不支持扩展图表。 2）上述所有获取对象的方法在移动端的实现方式跟 PC 端是有差异的，移动端只支持部分 JS 调用这些方法。 3）决策报表报表块内图表，仅支持移动端 11.0.63 及之后的版本调用部分 JS 。 | |
getChartWithIndex
| 方法 | getChartWithIndex(chartIndex) | 获取图表对象 |
|---|---|---|
| 参数 | chartIndex | 1）chartIndex 为数字型。 2）默认图表块里面只有一个图表，这时的 chartIndex 为 0。 3）当设置了图表切换，即一个图表块内有多个图表时，需要传入具体的 chartIndex 来获取具体的图表对象，这就意味着如果想获取第 n 个图表，那么传入的 chartIndex 应该为 n-1 |
| 示例 | 图表切换设置了 3 个图表，获取第 3 个图表对象 | |
| 移动端 | 支持 | |
getCurrentChartIndex()
| 方法 | getCurrentChartIndex() | 获取当前展示图表的chartIndex 多图表开启轮播时，不易使用 getChartWithIndex 的方法获取 chartIndex ，可能导致无法获取图表对象，此时需要使用 getCurrentChartIndex() 。 |
|---|---|---|
| 参数 | - | - |
| 示例 | | |
| 移动端 | 不支持移动端 | |
series
| 方法 | series[seriesIndex] | 获取系列对象 需在获取图表对象之后使用 |
|---|---|---|
| 参数 | seriesIndex | 默认的 chart 对象有一个 series 属性，该对象存储的是图表内系列相关的数据信息，是一个对象数组。如果想要获得图表中某一个具体的系列对象，则需要指定对应的索引 seriesIndex，seriesIndex 从 0 开始计数。 |
| 示例 | 示例1：对于饼图来说，一个系列就是一个饼图，例如需要表示第一个饼图的所有扇形的数据点。 示例2：假设已获取到图表对象 PieChart，现在想要获取里面的第 1 个系列对象，那么使用PieChart.series[0]即可得到，可以在浏览器中打印： | |
| 移动端 | 支持部分移动端调用 JS | |
series.points
| 方法 | series.points[pointIndex] | 获取数据点对象 需在获取图表对象之后使用 |
|---|---|---|
| 参数 | pointIndex | 每个 series 对象里面又有一个 points 的属性，也是一个对象数组，这个 points 数组里面存放的就是我们想要的 point 数据点对象。 如果需要获取某个具体的数据点对象，则需要指明该数据点的索引 pointIndex，pointIndex 从 0 开始计数 |
| 示例 | chart.series[0].points，可获取第一个系列下的所有数据点集合。那么如果想拿到图表下所有数据点的集合该怎么做呢？只需要一个简单的遍历操作便可以完成： | |
| 移动端 | 不支持移动端 | |
数据点对象中的属性
某些场景下，需要的可能只是满足某一特定条件下的一类数据点集合，这时可以通过 Array.filter 来指定过滤条件，从而筛选出想要的数据点集合。这里对数据点对象中的某些属性做一下介绍，编写过滤条件的时候需要使用：
| 属性 | 含义 |
|---|---|
| point.name | 数据点的名称 |
| point.seriesName | 数据点对应的系列名称 |
| point.category | 数据点对应的分类名 |
| point.value | 数据点的值 |
| point.isVisible | 判断数据点是否可见 |
| chart.showTooltip(point) | 触发数据点提示 |
示例：筛选值大于 0.1 的数据点的集合，写法如下：
var PieChart=FR.Chart.WebUtils.getChart("A1").getChartWithIndex(2);
var points = [];
PieChart.series.forEach(function (ser){
points = points.concat(ser.points);
})
points = points.filter(function (p){ return p.value > 0.1; })
