图表的导出默认是提交数据(SVG 字符串或图表配置 JSON 字符串 )到导出服务器上进行生成图片,另外我们提供的纯客户端导出的功能模块 可以不需要导出服务器就可以完成这个操作。
导出功能需要额外的引入相关的文件,下面是示例代码:
关于图表导出详细配置请参考 。
到启用了图表导出功能后,图表导出相关的功能按钮就会出现在图表的右上角,当点击按钮时,对应的导出操作菜单会展开,如下图所示:
导出按钮的样式可以通过 exporting.buttons.contextButton 及 里的项目进行调整;菜单可以通过 navigation 里的选项进行控制。
导出按钮及菜单的文字可以通过 相关配置进行本地化。
我们可以通过相关的函数来调用导出相关的功能,相关的函数包括 chart.print()
、 及 Chart.exportChartLocal()
1)打印图表
通过调用 即可打印图表。
我们可以在打印相关的事件回调函数 chart.events.beforePrint
及 里对图表打印之前及之后做处理,在 Highcharts 内部,图表在打印之前会调整到适合打印的尺寸,打印之后则恢复大小。
2)下载文件
chart.exportChart()
用于将图表导出,该函数包含两个参数 及 chartOptions
,下面是示例代码:
,更多内容请参考 API 文档。
Chart.exportChartLocal()
函数则是用本地导出,关于本地导出我们将在后面的教程里详细说明。
从 Highcharts 3.0 及 Highstock 1.3 开始,导出图片的大小基于以下规则:
配置了 和 chart.height ,那么导出尺寸就是这两个的参数值;
图表容器的设置了具体的宽度或高度的像素值,那么对应的高度或宽度生效。注意非像素值(比如百分比)的宽度或高度值是无效的;
默认的尺寸是 600 x 400 像素;
如果你需要控制提到导出服务器的数据,可以通过下面的参数(指的是发送 POST 请求参数)来配置。
|async|布尔类型,默认是 false,当设置为 true 是,返回的结果是图片路径,该文件路径在 30s 内有效(超时将会被删除),具体请参考
关于上面的参数使用可以参考我们提供的 导出服务测试页面