FineReport 8.0图表JS接口详解:功能与调用

需积分: 16 6 下载量 124 浏览量 更新于2024-09-10 收藏 595KB PDF 举报
"本文主要介绍了报表开发工具FineReport 8.0版本中开放的部分图表js接口,包括如何获取图表对象、设置图表的各种属性,如数据刷新、标题、图例、系列隐藏、标签显示等,以及警戒线的添加功能。" 在FineReport 8.0这个报表开发工具中,开发者可以通过利用开放的js接口来实现对图表的高级定制和交互操作。这些接口主要分为以下几个方面: 1. **获取图表对象**: - `FR.Chart.WebUtils.getChart("Cells__id")`:用于获取单元格内的图表对象。 - `FR.Chart.WebUtils.getChart("Float__id")`:用于获取悬浮元素中的图表对象。 - `FR.Chart.WebUtils.getChart("id")`:用于在表单中获取图表对象。 2. **图表属性设置**: - `chart.dataRefresh()`:重新从数据集获取数据并刷新图表,实现图表的动态更新。 - `chart.setTitleVisible(boolean)`:设置图表标题的可见性,参数为布尔值,`true`为显示,`false`为隐藏。 - `chart.setTitleContent()`:设置图表标题的内容,可以使用参数或值进行动态设置。 - `chart.setLegendVisible(boolean)`:控制图例的显示与否,参数同上。 - `chart.setSeriesInvisible([index])`:根据传入的数值数组,隐藏指定序列,例如`[0,1,3]`将隐藏系列1、2和4,同时其图例也会被灰化。 - `chart.setLabelVisible(boolean)`:设置图表上的数据标签的可见性。 3. **标签值设置**: - `chart.setLabelValue()`:针对不同类型的图表,提供了设置对应标签显示值的方法。如柱形图、面积图、折线图、条形图、圆环图、雷达图、组合图、全距图、饼图、散点图、气泡图、地图、GIS地图以及股价图、仪表盘和甘特图(不支持标签设置)。 4. **警戒线设置**: - `chart.addAlertLine(name, value, color, align, isUseSecondValueAxis)`:用于在图表上添加警戒线,设置警戒线名称、值、颜色、对齐方式(居左或居右/上),以及是否使用第二个值轴。 通过这些接口,开发者可以实现丰富的交互效果,如动态刷新图表数据、自定义标题内容、控制图例显示、隐藏特定序列、调整标签值以增强数据可视化效果,以及设置警戒线以突出关键阈值。这些功能极大地提升了报表的用户体验和信息传递效率,使FineReport成为一个强大的报表开发工具。