Export module 导出模块
导出模块允许您的用户将图表下载为PDF、PNG、JPG或SVG矢量图像。它还可以让用户直接打印图表,而不会被网页上的其他元素分散注意力。下载文件通常在客户端创建。导出为PDF需要加载第三方库的 offline-exporting.js 模块,否则PDF将由Highcharts的专用服务器生成,或者 可选地由您的服务器 自行托管your own server。
自版本12.3起,客户端导出成为默认设置。可以通过将 exporting.local设置为 false 来更改此行为。
注意: 如果你使用公共导出服务器 https://export.highcharts.com,你应当阅读 我们的 使用条款和公平使用政策Terms of use and Fair Usage Policy 以了解更多关于要求和限制的信息。
此外,还有 导出数据模块,它可以实现将图表数据导出为 CSV、XLS 或 HTML 表格格式。
要启用导出功能,需要包含该模块,可以从 https://code.highcharts.com/ 下载,并在highcharts.js或highstock.js之后引入。该模块也可以直接从 https://code.highcharts.com/ 引入,方法如下:
<script src="https://code.highcharts.com/modules/exporting.js"></script>
<!– optional –>
<script src="https://code.highcharts.com/modules/offline-exporting.js"></script>
<script src="https://code.highcharts.com/modules/export-data.js"></script>
The button 按钮
启用后,图表右上角会出现一个带有菜单的上下文按钮。
按钮的位置以及各种样式可以通过编辑 navigation.buttonOptions and exporting.buttons.contextButton.
为了充分发挥HTML5的全部功能,你还可以完全忽略我们内置的按钮和菜单,自己创建按钮或链接,调用 Chart.print()或 Chart.exportChart() 并传入参数。
控制导出图片的大小
自 Highcharts 3.0 和 Highcharts Stock 1.3 版本起,导出图片的尺寸会根据一些规则进行计算:
-
如果设置了 exporting.sourceWidth 和 exporting.sourceHeight 选项,它们将优先使用。这为在屏幕显示的图表和导出图表设置不同尺寸提供了方便的方式。
-
如果没有设置,并且设置了 chart.width 和 chart.height 选项,则会使用这些值作为导出图表的尺寸。
-
如果还没有找到尺寸,并且 包含该图表的 div 有明确的像素宽度或高度,则会使用该宽度或高度。百分比和其他非像素宽度将不会生效。这避免了在 Highcharts 2 中的一个常见陷阱,即宽度为 100% 的图表在导出时看起来比例失调。
-
如果仍未找到合适的尺寸,则默认为 600 像素宽,400 像素高。
-在使用上述尺寸渲染图表后,所有文本的大小相对于此尺寸,实际图像的分辨率由导出比例决定,默认值为2。实际上,这意味着一个600×400的图表默认会生成一个1200×800像素的图像。其背后的原理很简单——如果我们使用比例1,只将源宽度设为1200,源高度设为800,所有文本都会变得太小。而如果不放大,分辨率又太低,无法用于打印。
导出图表中的网页字体
从 12.3 版本开始,通过 CSS 中的 @font-face 规则加载的外部字体会包含在导出图片中。 这是通过在导出过程中单独获取和解析外部样式表实现的。
如果你想排除这些字体,可以通过在导出选项中显式设置 fontFamily 来覆盖此行为:






