UNPKG

highcharts

Version:
1,252 lines (1,082 loc) 54.7 kB
/** * @license Highcharts JS v5.0.13 (2017-07-27) * Exporting module * * (c) 2010-2017 Torstein Honsi * * License: www.highcharts.com/license */ 'use strict'; (function(factory) { if (typeof module === 'object' && module.exports) { module.exports = factory; } else { factory(Highcharts); } }(function(Highcharts) { (function(H) { /** * Exporting module * * (c) 2010-2017 Torstein Honsi * * License: www.highcharts.com/license */ /* eslint indent:0 */ // create shortcuts var defaultOptions = H.defaultOptions, doc = H.doc, Chart = H.Chart, addEvent = H.addEvent, removeEvent = H.removeEvent, fireEvent = H.fireEvent, createElement = H.createElement, discardElement = H.discardElement, css = H.css, merge = H.merge, pick = H.pick, each = H.each, objectEach = H.objectEach, extend = H.extend, isTouchDevice = H.isTouchDevice, win = H.win, userAgent = win.navigator.userAgent, SVGRenderer = H.SVGRenderer, symbols = H.Renderer.prototype.symbols, isMSBrowser = /Edge\/|Trident\/|MSIE /.test(userAgent), isFirefoxBrowser = /firefox/i.test(userAgent); // Add language /** * @apioption lang */ extend(defaultOptions.lang, { printChart: 'Print chart', downloadPNG: 'Download PNG image', downloadJPEG: 'Download JPEG image', downloadPDF: 'Download PDF document', downloadSVG: 'Download SVG vector image', contextButtonTitle: 'Chart context menu' }); // Buttons and menus are collected in a separate config option set called 'navigation'. // This can be extended later to add control buttons like zoom and pan right click menus. /** * @apioption navigation */ defaultOptions.navigation = { buttonOptions: { theme: {}, symbolSize: 14, symbolX: 12.5, symbolY: 10.5, align: 'right', buttonSpacing: 3, height: 22, // text: null, verticalAlign: 'top', width: 24 } }; // Presentational attributes merge(true, defaultOptions.navigation, /** * A collection of options for buttons and menus appearing in the exporting module. * @type {Object} * @optionparent navigation */ { /** * CSS styles for the popup menu appearing by default when the export * icon is clicked. This menu is rendered in HTML. * * @type {CSSObject} * @see In [styled mode](http://www.highcharts.com/docs/chart-design-and- * style/style-by-css), the menu is styled with the `.highcharts-menu` * class. * @sample {highcharts} highcharts/navigation/menustyle/ Light gray menu background * @sample {highstock} highcharts/navigation/menustyle/ Light gray menu background * @sample {highmaps} highcharts/navigation/menustyle/ Light gray menu background * @default { "border": "1px solid #999999", "background": "#ffffff", "padding": "5px 0" } * @since 2.0 * @product highcharts highstock highmaps */ menuStyle: { /** */ border: '1px solid #999999', /** */ background: '#ffffff', /** */ padding: '5px 0' }, /** * CSS styles for the individual items within the popup menu appearing * by default when the export icon is clicked. The menu items are rendered * in HTML. * * @type {CSSObject} * @see In [styled mode](http://www.highcharts.com/docs/chart-design-and- * style/style-by-css), the menu items are styled with the `.highcharts- * menu-item` class. * @sample {highcharts} highcharts/navigation/menuitemstyle/ Add a grey stripe to the left * @sample {highstock} highcharts/navigation/menuitemstyle/ Add a grey stripe to the left * @sample {highmaps} highcharts/navigation/menuitemstyle/ Add a grey stripe to the left * @default { "padding": "0.5em 1em", "color": "#333333", "background": "none" } * @since 2.0 * @product highcharts highstock highmaps */ menuItemStyle: { /** */ padding: '0.5em 1em', /** */ background: 'none', /** */ color: '#333333', /** */ fontSize: isTouchDevice ? '14px' : '11px', /** */ transition: 'background 250ms, color 250ms' }, /** * CSS styles for the hover state of the individual items within the * popup menu appearing by default when the export icon is clicked. * The menu items are rendered in HTML. * * @type {CSSObject} * @see In [styled mode](http://www.highcharts.com/docs/chart-design-and- * style/style-by-css), the menu items are styled with the `.highcharts- * menu-item` class. * @sample {highcharts} highcharts/navigation/menuitemhoverstyle/ Bold text on hover * @sample {highstock} highcharts/navigation/menuitemhoverstyle/ Bold text on hover * @sample {highmaps} highcharts/navigation/menuitemhoverstyle/ Bold text on hover * @default { "background": "#335cad", "color": "#ffffff" } * @since 2.0 * @product highcharts highstock highmaps */ menuItemHoverStyle: { /** */ background: '#335cad', /** */ color: '#ffffff' }, /** * A collection of options for buttons appearing in the exporting module. * * * In [styled mode](http://www.highcharts.com/docs/chart-design-and- * style/style-by-css), the buttons are styled with the `.highcharts- * contextbutton` and `.highcharts-button-symbol` class. * * @product highcharts highstock highmaps */ buttonOptions: { /** * Fill color for the symbol within the button. * * @type {Color} * @sample {highcharts} highcharts/navigation/buttonoptions-symbolfill/ Blue symbol stroke for one of the buttons * @sample {highstock} highcharts/navigation/buttonoptions-symbolfill/ Blue symbol stroke for one of the buttons * @sample {highmaps} highcharts/navigation/buttonoptions-symbolfill/ Blue symbol stroke for one of the buttons * @default #666666 * @since 2.0 * @product highcharts highstock highmaps */ symbolFill: '#666666', /** * The color of the symbol's stroke or line. * * @type {Color} * @sample {highcharts} highcharts/navigation/buttonoptions-symbolstroke/ Blue symbol stroke * @sample {highstock} highcharts/navigation/buttonoptions-symbolstroke/ Blue symbol stroke * @sample {highmaps} highcharts/navigation/buttonoptions-symbolstroke/ Blue symbol stroke * @default #666666 * @since 2.0 * @product highcharts highstock highmaps */ symbolStroke: '#666666', /** * The pixel stroke width of the symbol on the button. * * @type {Number} * @sample {highcharts} highcharts/navigation/buttonoptions-height/ Bigger buttons * @sample {highstock} highcharts/navigation/buttonoptions-height/ Bigger buttons * @sample {highmaps} highcharts/navigation/buttonoptions-height/ Bigger buttons * @default 1 * @since 2.0 * @product highcharts highstock highmaps */ symbolStrokeWidth: 3, /** * A configuration object for the button theme. The object accepts * SVG properties like `stroke-width`, `stroke` and `fill`. Tri-state * button styles are supported by the `states.hover` and `states.select` * objects. * * @type {Object} * @sample {highcharts} highcharts/navigation/buttonoptions-theme/ Theming the buttons * @sample {highstock} highcharts/navigation/buttonoptions-theme/ Theming the buttons * @sample {highmaps} highcharts/navigation/buttonoptions-theme/ Theming the buttons * @since 3.0 * @product highcharts highstock highmaps */ theme: { /** */ fill: '#ffffff', // capture hover /** */ stroke: 'none', /** */ padding: 5 } } }); // Add the export related options /** * Options for the exporting module. For an overview on the matter, see [the docs](http://www.highcharts.com/docs/export-module/export-module-overview). * @type {Object} * @optionparent exporting */ defaultOptions.exporting = { //enabled: true, //filename: 'chart', /** * Default MIME type for exporting if `chart.exportChart()` is called * without specifying a `type` option. Possible values are `image/png`, * `image/jpeg`, `application/pdf` and `image/svg+xml`. * * @validvalue ["image/png", "image/jpeg", "application/pdf", "image/svg+xml"] * @type {String} * @default image/png * @since 2.0 * @product highcharts highstock highmaps */ type: 'image/png', /** * The URL for the server module converting the SVG string to an image * format. By default this points to Highchart's free web service. * * @type {String} * @default https://export.highcharts.com * @since 2.0 * @product highcharts highstock highmaps */ url: 'https://export.highcharts.com/', //width: undefined, /** * When printing the chart from the menu item in the burger menu, if * the on-screen chart exceeds this width, it is resized. After printing * or cancelled, it is restored. The default width makes the chart * fit into typical paper format. Note that this does not affect the * chart when printing the web page as a whole. * * @type {Number} * @default 780 * @since 4.2.5 * @product highcharts highstock highmaps */ printMaxWidth: 780, /** * Defines the scale or zoom factor for the exported image compared * to the on-screen display. While for instance a 600px wide chart * may look good on a website, it will look bad in print. The default * scale of 2 makes this chart export to a 1200px PNG or JPG. * * @type {Number} * @see [chart.width](#chart.width), [exporting.sourceWidth](#exporting. * sourceWidth) * @sample {highcharts} highcharts/exporting/scale/ Scale demonstrated * @sample {highstock} highcharts/exporting/scale/ Scale demonstrated * @sample {highmaps} maps/exporting/scale/ Scale demonstrated * @default 2 * @since 3.0 * @product highcharts highstock highmaps */ scale: 2, /** * Options for the export related buttons, print and export. In addition * to the default buttons listed here, custom buttons can be added. * See [navigation.buttonOptions](#navigation.buttonOptions) for general * options. * * @product highcharts highstock highmaps */ buttons: { /** * Options for the export button. * * In [styled mode](http://www.highcharts.com/docs/chart-design-and- * style/style-by-css), export button styles can be applied with the * `.highcharts-contextbutton` class. * * @extends navigation.buttonOptions * @product highcharts highstock highmaps */ contextButton: { /** */ className: 'highcharts-contextbutton', /** */ menuClassName: 'highcharts-contextmenu', //x: -10, /** * The symbol for the button. Points to a definition function in * the `Highcharts.Renderer.symbols` collection. The default `exportIcon` * function is part of the exporting module. * * @validvalue ["circle", "square", "diamond", "triangle", "triangle-down", "menu"] * @type {String} * @sample {highcharts} highcharts/exporting/buttons-contextbutton-symbol/ Use a circle for symbol * @sample {highstock} highcharts/exporting/buttons-contextbutton-symbol/ Use a circle for symbol * @sample {highmaps} highcharts/exporting/buttons-contextbutton-symbol/ Use a circle for symbol * @default menu * @since 2.0 * @product highcharts highstock highmaps */ symbol: 'menu', /** */ _titleKey: 'contextButtonTitle', /** * A collection of config options for the menu items. Each options * object consists of a `text` option which is a string to show in * the menu item, as well as an `onclick` parameter which is a callback * function to run on click. * * By default, there is the "Print" menu item plus one menu item * for each of the available export types. Menu items can be customized * by defining a new array of items and assigning `null` to unwanted * positions (see override example below). * * @type {Array<Object>} * @sample {highcharts} highcharts/exporting/buttons-contextbutton-onclick/ Skip the menu and export the chart directly * @sample {highcharts} highcharts/exporting/buttons-contextbutton-menuitems/ Override the menu items * @sample {highstock} highcharts/exporting/buttons-contextbutton-onclick/ Skip the menu and export the chart directly * @sample {highstock} highcharts/exporting/buttons-contextbutton-menuitems/ Override the menu items * @sample {highmaps} highcharts/exporting/buttons-contextbutton-onclick/ Skip the menu and export the chart directly * @sample {highmaps} highcharts/exporting/buttons-contextbutton-menuitems/ Override the menu items * @since 2.0 * @product highcharts highstock highmaps */ menuItems: [ 'printChart', 'separator', 'downloadPNG', 'downloadJPEG', 'downloadPDF', 'downloadSVG' ] } }, // docs. Created API item with since:next. Add information and link to sample // from menuItems too. /** * An object consisting of definitions for the menu items in the context * menu. Each key value pair has a `key` that is referenced in the * [menuItems](#exporting.buttons.contextButton.menuItems) setting, * and a `value`, which is an object with the following properties: * * <dl> * * <dt>onclick</dt> * * <dd>The click handler for the menu item</dd> * * <dt>text</dt> * * <dd>The text for the menu item</dd> * * <dt>textKey</dt> * * <dd>If internationalization is required, the key to a language string</dd> * * </dl> * * @type {Object} * @sample {highcharts} highcharts/exporting/menuitemdefinitions/ Menu item definitions * @sample {highstock} highcharts/exporting/menuitemdefinitions/ Menu item definitions * @sample {highmaps} highcharts/exporting/menuitemdefinitions/ Menu item definitions * @since next * @product highcharts highstock highmaps */ menuItemDefinitions: { /** */ printChart: { /** */ textKey: 'printChart', /** */ onclick: function() { this.print(); } }, /** */ separator: { /** */ separator: true }, /** */ downloadPNG: { /** */ textKey: 'downloadPNG', /** */ onclick: function() { this.exportChart(); } }, /** */ downloadJPEG: { /** */ textKey: 'downloadJPEG', /** */ onclick: function() { this.exportChart({ type: 'image/jpeg' }); } }, /** */ downloadPDF: { /** */ textKey: 'downloadPDF', /** */ onclick: function() { this.exportChart({ type: 'application/pdf' }); } }, /** */ downloadSVG: { /** */ textKey: 'downloadSVG', /** */ onclick: function() { this.exportChart({ type: 'image/svg+xml' }); } } } }; /** * Fires after a chart is printed through the context menu item or the * `Chart.print` method. Requires the exporting module. * * @type {Function} * @context Chart * @sample {highcharts} highcharts/chart/events-beforeprint-afterprint/ * Rescale the chart to print * @sample {highstock} highcharts/chart/events-beforeprint-afterprint/ * Rescale the chart to print * @sample {highmaps} highcharts/chart/events-beforeprint-afterprint/ * Rescale the chart to print * @since 4.1.0 * @apioption chart.events.afterPrint */ /** * Fires before a chart is printed through the context menu item or * the `Chart.print` method. Requires the exporting module. * * @type {Function} * @context Chart * @sample {highcharts} highcharts/chart/events-beforeprint-afterprint/ * Rescale the chart to print * @sample {highstock} highcharts/chart/events-beforeprint-afterprint/ * Rescale the chart to print * @sample {highmaps} highcharts/chart/events-beforeprint-afterprint/ * Rescale the chart to print * @since 4.1.0 * @apioption chart.events.beforePrint */ // Add the H.post utility H.post = function(url, data, formAttributes) { // create the form var form = createElement('form', merge({ method: 'post', action: url, enctype: 'multipart/form-data' }, formAttributes), { display: 'none' }, doc.body); // add the data objectEach(data, function(val, name) { createElement('input', { type: 'hidden', name: name, value: val }, null, form); }); // submit form.submit(); // clean up discardElement(form); }; extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ { /** * Exporting module only. A collection of fixes on the produced SVG to * account for expando properties, browser bugs, VML problems and other. * Returns a cleaned SVG. * * @private */ sanitizeSVG: function(svg, options) { // Move HTML into a foreignObject if (options && options.exporting && options.exporting.allowHTML) { var html = svg.match(/<\/svg>(.*?$)/); if (html && html[1]) { html = '<foreignObject x="0" y="0" ' + 'width="' + options.chart.width + '" ' + 'height="' + options.chart.height + '">' + '<body xmlns="http://www.w3.org/1999/xhtml">' + html[1] + '</body>' + '</foreignObject>'; svg = svg.replace('</svg>', html + '</svg>'); } } svg = svg .replace(/zIndex="[^"]+"/g, '') .replace(/isShadow="[^"]+"/g, '') .replace(/symbolName="[^"]+"/g, '') .replace(/jQuery[0-9]+="[^"]+"/g, '') .replace(/url\(("|&quot;)(\S+)("|&quot;)\)/g, 'url($2)') .replace(/url\([^#]+#/g, 'url(#') .replace(/<svg /, '<svg xmlns:xlink="http://www.w3.org/1999/xlink" ') .replace(/ (NS[0-9]+\:)?href=/g, ' xlink:href=') // #3567 .replace(/\n/, ' ') // Any HTML added to the container after the SVG (#894) .replace(/<\/svg>.*?$/, '</svg>') // Batik doesn't support rgba fills and strokes (#3095) .replace(/(fill|stroke)="rgba\(([ 0-9]+,[ 0-9]+,[ 0-9]+),([ 0-9\.]+)\)"/g, '$1="rgb($2)" $1-opacity="$3"') /* This fails in IE < 8 .replace(/([0-9]+)\.([0-9]+)/g, function(s1, s2, s3) { // round off to save weight return s2 +'.'+ s3[0]; })*/ // Replace HTML entities, issue #347 .replace(/&nbsp;/g, '\u00A0') // no-break space .replace(/&shy;/g, '\u00AD'); // soft hyphen // IE specific svg = svg .replace(/<IMG /g, '<image ') .replace(/<(\/?)TITLE>/g, '<$1title>') .replace(/height=([^" ]+)/g, 'height="$1"') .replace(/width=([^" ]+)/g, 'width="$1"') .replace(/hc-svg-href="([^"]+)">/g, 'xlink:href="$1"/>') .replace(/ id=([^" >]+)/g, ' id="$1"') // #4003 .replace(/class=([^" >]+)/g, 'class="$1"') .replace(/ transform /g, ' ') .replace(/:(path|rect)/g, '$1') .replace(/style="([^"]+)"/g, function(s) { return s.toLowerCase(); }); return svg; }, /** * Return the unfiltered innerHTML of the chart container. Used as hook for * plugins. In styled mode, it also takes care of inlining CSS style rules. * * @see Chart#getSVG * * @returns {String} * The unfiltered SVG of the chart. */ getChartHTML: function() { return this.container.innerHTML; }, /** * Return an SVG representation of the chart. * * @param chartOptions {Options} * Additional chart options for the generated SVG representation. * For collections like `xAxis`, `yAxis` or `series`, the additional * options is either merged in to the orininal item of the same * `id`, or to the first item if a common id is not found. * @return {String} * The SVG representation of the rendered chart. * @sample highcharts/members/chart-getsvg/ * View the SVG from a button */ getSVG: function(chartOptions) { var chart = this, chartCopy, sandbox, svg, seriesOptions, sourceWidth, sourceHeight, cssWidth, cssHeight, options = merge(chart.options, chartOptions); // copy the options and add extra options // IE compatibility hack for generating SVG content that it doesn't really understand if (!doc.createElementNS) { doc.createElementNS = function(ns, tagName) { return doc.createElement(tagName); }; } // create a sandbox where a new chart will be generated sandbox = createElement('div', null, { position: 'absolute', top: '-9999em', width: chart.chartWidth + 'px', height: chart.chartHeight + 'px' }, doc.body); // get the source size cssWidth = chart.renderTo.style.width; cssHeight = chart.renderTo.style.height; sourceWidth = options.exporting.sourceWidth || options.chart.width || (/px$/.test(cssWidth) && parseInt(cssWidth, 10)) || 600; sourceHeight = options.exporting.sourceHeight || options.chart.height || (/px$/.test(cssHeight) && parseInt(cssHeight, 10)) || 400; // override some options extend(options.chart, { animation: false, renderTo: sandbox, forExport: true, renderer: 'SVGRenderer', width: sourceWidth, height: sourceHeight }); options.exporting.enabled = false; // hide buttons in print delete options.data; // #3004 // prepare for replicating the chart options.series = []; each(chart.series, function(serie) { seriesOptions = merge(serie.userOptions, { // #4912 animation: false, // turn off animation enableMouseTracking: false, showCheckbox: false, visible: serie.visible }); if (!seriesOptions.isInternal) { // used for the navigator series that has its own option set options.series.push(seriesOptions); } }); // Assign an internal key to ensure a one-to-one mapping (#5924) each(chart.axes, function(axis) { if (!axis.userOptions.internalKey) { // #6444 axis.userOptions.internalKey = H.uniqueKey(); } }); // generate the chart copy chartCopy = new H.Chart(options, chart.callback); // Axis options and series options (#2022, #3900, #5982) if (chartOptions) { each(['xAxis', 'yAxis', 'series'], function(coll) { var collOptions = {}; if (chartOptions[coll]) { collOptions[coll] = chartOptions[coll]; chartCopy.update(collOptions); } }); } // Reflect axis extremes in the export (#5924) each(chart.axes, function(axis) { var axisCopy = H.find(chartCopy.axes, function(copy) { return copy.options.internalKey === axis.userOptions.internalKey; }), extremes = axis.getExtremes(), userMin = extremes.userMin, userMax = extremes.userMax; if (axisCopy && (userMin !== undefined || userMax !== undefined)) { axisCopy.setExtremes(userMin, userMax, true, false); } }); // Get the SVG from the container's innerHTML svg = chartCopy.getChartHTML(); svg = chart.sanitizeSVG(svg, options); // free up memory options = null; chartCopy.destroy(); discardElement(sandbox); return svg; }, getSVGForExport: function(options, chartOptions) { var chartExportingOptions = this.options.exporting; return this.getSVG(merge({ chart: { borderRadius: 0 } }, chartExportingOptions.chartOptions, chartOptions, { exporting: { sourceWidth: (options && options.sourceWidth) || chartExportingOptions.sourceWidth, sourceHeight: (options && options.sourceHeight) || chartExportingOptions.sourceHeight } } )); }, /** * Exporting module required. Submit an SVG version of the chart to a server * along with some parameters for conversion. * @param {Object} exportingOptions * Exporting options in addition to those defined in {@link * https://api.highcharts.com/highcharts/exporting|exporting}. * @param {String} exportingOptions.filename * The file name for the export without extension. * @param {String} exportingOptions.url * The URL for the server module to do the conversion. * @param {Number} exportingOptions.width * The width of the PNG or JPG image generated on the server. * @param {String} exportingOptions.type * The MIME type of the converted image. * @param {Number} exportingOptions.sourceWidth * The pixel width of the source (in-page) chart. * @param {Number} exportingOptions.sourceHeight * The pixel height of the source (in-page) chart. * @param {Options} chartOptions * Additional chart options for the exported chart. For example a * different background color can be added here, or `dataLabels` * for export only. * * @sample highcharts/members/chart-exportchart/ * Export with no options * @sample highcharts/members/chart-exportchart-filename/ * PDF type and custom filename * @sample highcharts/members/chart-exportchart-custom-background/ * Different chart background in export * @sample stock/members/chart-exportchart/ * Export with Highstock */ exportChart: function(exportingOptions, chartOptions) { var svg = this.getSVGForExport(exportingOptions, chartOptions); // merge the options exportingOptions = merge(this.options.exporting, exportingOptions); // do the post H.post(exportingOptions.url, { filename: exportingOptions.filename || 'chart', type: exportingOptions.type, width: exportingOptions.width || 0, // IE8 fails to post undefined correctly, so use 0 scale: exportingOptions.scale, svg: svg }, exportingOptions.formAttributes); }, /** * Exporting module required. Clears away other elements in the page and * prints the chart as it is displayed. By default, when the exporting * module is enabled, a context button with a drop down menu in the upper * right corner accesses this function. * * @sample highcharts/members/chart-print/ * Print from a HTML button */ print: function() { var chart = this, container = chart.container, origDisplay = [], origParent = container.parentNode, body = doc.body, childNodes = body.childNodes, printMaxWidth = chart.options.exporting.printMaxWidth, resetParams, handleMaxWidth; if (chart.isPrinting) { // block the button while in printing mode return; } chart.isPrinting = true; chart.pointer.reset(null, 0); fireEvent(chart, 'beforePrint'); // Handle printMaxWidth handleMaxWidth = printMaxWidth && chart.chartWidth > printMaxWidth; if (handleMaxWidth) { resetParams = [chart.options.chart.width, undefined, false]; chart.setSize(printMaxWidth, undefined, false); } // hide all body content each(childNodes, function(node, i) { if (node.nodeType === 1) { origDisplay[i] = node.style.display; node.style.display = 'none'; } }); // pull out the chart body.appendChild(container); // print win.focus(); // #1510 win.print(); // allow the browser to prepare before reverting setTimeout(function() { // put the chart back in origParent.appendChild(container); // restore all body content each(childNodes, function(node, i) { if (node.nodeType === 1) { node.style.display = origDisplay[i]; } }); chart.isPrinting = false; // Reset printMaxWidth if (handleMaxWidth) { chart.setSize.apply(chart, resetParams); } fireEvent(chart, 'afterPrint'); }, 1000); }, /** * Display a popup menu for choosing the export type. * * @private * * @param {String} className An identifier for the menu * @param {Array} items A collection with text and onclicks for the items * @param {Number} x The x position of the opener button * @param {Number} y The y position of the opener button * @param {Number} width The width of the opener button * @param {Number} height The height of the opener button */ contextMenu: function(className, items, x, y, width, height, button) { var chart = this, navOptions = chart.options.navigation, chartWidth = chart.chartWidth, chartHeight = chart.chartHeight, cacheName = 'cache-' + className, menu = chart[cacheName], menuPadding = Math.max(width, height), // for mouse leave detection innerMenu, hide, menuStyle; // create the menu only the first time if (!menu) { // create a HTML element above the SVG chart[cacheName] = menu = createElement('div', { className: className }, { position: 'absolute', zIndex: 1000, padding: menuPadding + 'px' }, chart.container); innerMenu = createElement('div', { className: 'highcharts-menu' }, null, menu); // Presentational CSS css(innerMenu, extend({ MozBoxShadow: '3px 3px 10px #888', WebkitBoxShadow: '3px 3px 10px #888', boxShadow: '3px 3px 10px #888' }, navOptions.menuStyle)); // hide on mouse out hide = function() { css(menu, { display: 'none' }); if (button) { button.setState(0); } chart.openMenu = false; }; // Hide the menu some time after mouse leave (#1357) chart.exportEvents.push( addEvent(menu, 'mouseleave', function() { menu.hideTimer = setTimeout(hide, 500); }), addEvent(menu, 'mouseenter', function() { clearTimeout(menu.hideTimer); }), // Hide it on clicking or touching outside the menu (#2258, #2335, // #2407) addEvent(doc, 'mouseup', function(e) { if (!chart.pointer.inClass(e.target, className)) { hide(); } }) ); // create the items each(items, function(item) { if (typeof item === 'string') { item = chart.options.exporting.menuItemDefinitions[item]; } if (H.isObject(item, true)) { var element; if (item.separator) { element = createElement('hr', null, null, innerMenu); } else { element = createElement('div', { className: 'highcharts-menu-item', onclick: function(e) { if (e) { // IE7 e.stopPropagation(); } hide(); if (item.onclick) { item.onclick.apply(chart, arguments); } }, innerHTML: item.text || chart.options.lang[item.textKey] }, null, innerMenu); element.onmouseover = function() { css(this, navOptions.menuItemHoverStyle); }; element.onmouseout = function() { css(this, navOptions.menuItemStyle); }; css(element, extend({ cursor: 'pointer' }, navOptions.menuItemStyle)); } // Keep references to menu divs to be able to destroy them chart.exportDivElements.push(element); } }); // Keep references to menu and innerMenu div to be able to destroy them chart.exportDivElements.push(innerMenu, menu); chart.exportMenuWidth = menu.offsetWidth; chart.exportMenuHeight = menu.offsetHeight; } menuStyle = { display: 'block' }; // if outside right, right align it if (x + chart.exportMenuWidth > chartWidth) { menuStyle.right = (chartWidth - x - width - menuPadding) + 'px'; } else { menuStyle.left = (x - menuPadding) + 'px'; } // if outside bottom, bottom align it if (y + height + chart.exportMenuHeight > chartHeight && button.alignOptions.verticalAlign !== 'top') { menuStyle.bottom = (chartHeight - y - menuPadding) + 'px'; } else { menuStyle.top = (y + height - menuPadding) + 'px'; } css(menu, menuStyle); chart.openMenu = true; }, /** * Add the export button to the chart, with options. * * @private */ addButton: function(options) { var chart = this, renderer = chart.renderer, btnOptions = merge(chart.options.navigation.buttonOptions, options), onclick = btnOptions.onclick, menuItems = btnOptions.menuItems, symbol, button, symbolSize = btnOptions.symbolSize || 12; if (!chart.btnCount) { chart.btnCount = 0; } // Keeps references to the button elements if (!chart.exportDivElements) { chart.exportDivElements = []; chart.exportSVGElements = []; } if (btnOptions.enabled === false) { return; } var attr = btnOptions.theme, states = attr.states, hover = states && states.hover, select = states && states.select, callback; delete attr.states; if (onclick) { callback = function(e) { e.stopPropagation(); onclick.call(chart, e); }; } else if (menuItems) { callback = function() { chart.contextMenu( button.menuClassName, menuItems, button.translateX, button.translateY, button.width, button.height, button ); button.setState(2); }; } if (btnOptions.text && btnOptions.symbol) { attr.paddingLeft = pick(attr.paddingLeft, 25); } else if (!btnOptions.text) { extend(attr, { width: btnOptions.width, height: btnOptions.height, padding: 0 }); } button = renderer.button(btnOptions.text, 0, 0, callback, attr, hover, select) .addClass(options.className) .attr({ 'stroke-linecap': 'round', title: chart.options.lang[btnOptions._titleKey], zIndex: 3 // #4955 }); button.menuClassName = options.menuClassName || 'highcharts-menu-' + chart.btnCount++; if (btnOptions.symbol) { symbol = renderer.symbol( btnOptions.symbol, btnOptions.symbolX - (symbolSize / 2), btnOptions.symbolY - (symbolSize / 2), symbolSize, symbolSize ) .addClass('highcharts-button-symbol') .attr({ zIndex: 1 }).add(button); symbol.attr({ stroke: btnOptions.symbolStroke, fill: btnOptions.symbolFill, 'stroke-width': btnOptions.symbolStrokeWidth || 1 }); } button.add() .align(extend(btnOptions, { width: button.width, x: pick(btnOptions.x, chart.buttonOffset) // #1654 }), true, 'spacingBox'); chart.buttonOffset += (button.width + btnOptions.buttonSpacing) * (btnOptions.align === 'right' ? -1 : 1); chart.exportSVGElements.push(button, symbol); }, /** * Destroy the export buttons. * * @private */ destroyExport: function(e) { var chart = e ? e.target : this, exportSVGElements = chart.exportSVGElements, exportDivElements = chart.exportDivElements, exportEvents = chart.exportEvents, cacheName; // Destroy the extra buttons added if (exportSVGElements) { each(exportSVGElements, function(elem, i) { // Destroy and null the svg/vml elements