highcharts 9.3.1 → 10.0.0

package/es-modules/Extensions/Drilldown.js

@@ -29,6 +29,7 @@ var seriesTypes = SeriesRegistry.seriesTypes;
 import SVGRenderer from '../Core/Renderer/SVG/SVGRenderer.js';
 import Tick from '../Core/Axis/Tick.js';
 import U from '../Core/Utilities.js';
+import Breadcrumbs from './Breadcrumbs.js';
 var addEvent = U.addEvent, removeEvent = U.removeEvent, extend = U.extend, fireEvent = U.fireEvent, merge = U.merge, objectEach = U.objectEach, pick = U.pick, syncTimeout = U.syncTimeout;
 /**
  * Gets fired when a drilldown point is clicked, before the new series is added.
@@ -151,18 +152,20 @@ extend(defaultOptions.lang,
  * @optionparent lang
  */
 {
-    /**
-     * The text for the button that appears when drilling down, linking back
-     * to the parent series. The parent series' name is inserted for
-     * `{series.name}`.
-     *
-     * @since    3.0.8
-     * @product  highcharts highmaps
-     * @requires modules/drilldown
-     *
-     * @private
-     */
-    drillUpText: '◁ Back to {series.name}'
+/**
+ * The text for the button that appears when drilling down, linking back
+ * to the parent series. The parent series' name is inserted for
+ * `{series.name}`.
+ *
+ * @since    3.0.8
+ * @product  highcharts highmaps
+ * @requires modules/drilldown
+ * @apioption lang.drillUpText
+ *
+ * @deprecated
+ *
+ * @private
+ */
 });
 /**
  * Options for drill down, the concept of inspecting increasingly high
@@ -194,6 +197,15 @@ defaultOptions.drilldown = {
      * @product   highcharts
      * @apioption drilldown.allowPointDrilldown
      */
+    /**
+     * Options for the breadcrumbs, the navigation at the top leading the way
+     * up through the drilldown levels.
+     *
+     * @since 10.0.0
+     * @product   highcharts
+     * @extends   navigation.breadcrumbs
+     * @optionparent drilldown.breadcrumbs
+     */
     /**
      * An array of series configurations for the drill down. Each series
      * configuration uses the same syntax as the [series](#series) option set.
@@ -280,17 +292,23 @@ defaultOptions.drilldown = {
         duration: 500
     },
     /**
+     *
      * Options for the drill up button that appears when drilling down on a
      * series. The text for the button is defined in
      * [lang.drillUpText](#lang.drillUpText).
      *
-     * @sample {highcharts} highcharts/drilldown/drillupbutton/
-     *         Drill up button
-     * @sample {highmaps} highcharts/drilldown/drillupbutton/
-     *         Drill up button
+     * This option is deprecated since 9.3.2, use `drilldown.breadcrumbs`
+     * instead.
+     *
+     * @sample highcharts/breadcrumbs/single-button
+     *         Breadcrumbs set up like a legacy button
+     * @sample {highcharts} highcharts/drilldown/drillupbutton/ Drill up button
+     * @sample {highmaps} highcharts/drilldown/drillupbutton/ Drill up button
      *
      * @since   3.0.8
      * @product highcharts highmaps
+     *
+     * @deprecated
      */
     drillUpButton: {
         /**
@@ -318,7 +336,7 @@ defaultOptions.drilldown = {
          * @sample {highmaps} highcharts/drilldown/drillupbutton/
          *         Button theming
          *
-         * @type      {object}
+         * @type      {Object}
          * @since     3.0.8
          * @product   highcharts highmaps
          * @apioption drilldown.drillUpButton.theme
@@ -576,44 +594,50 @@ Chart.prototype.applyDrilldown = function () {
         delete this.resetZoomButton;
     }
     this.pointer.reset();
-    this.redraw();
-    this.showDrillUpButton();
     fireEvent(this, 'afterDrilldown');
+    this.redraw();
+    fireEvent(this, 'afterApplyDrilldown');
 };
-Chart.prototype.getDrilldownBackText = function () {
-    var drilldownLevels = this.drilldownLevels, lastLevel;
-    if (drilldownLevels && drilldownLevels.length > 0) { // #3352, async loading
-        lastLevel = drilldownLevels[drilldownLevels.length - 1];
-        lastLevel.series = lastLevel.seriesOptions;
-        return format(this.options.lang.drillUpText || '', lastLevel);
-    }
-};
-Chart.prototype.showDrillUpButton = function () {
-    var chart = this, backText = this.getDrilldownBackText(), buttonOptions = chart.options.drilldown.drillUpButton, attr, states, alignTo = (buttonOptions.relativeTo === 'chart' ||
-        buttonOptions.relativeTo === 'spacingBox' ?
-        null :
-        'scrollablePlotBox');
-    if (!this.drillUpButton) {
-        attr = buttonOptions.theme;
-        states = attr && attr.states;
-        this.drillUpButton = this.renderer
-            .button(backText, null, null, function () {
-            chart.drillUp();
-        }, attr, states && states.hover, states && states.select)
-            .addClass('highcharts-drillup-button')
-            .attr({
-            align: buttonOptions.position.align,
-            zIndex: 7
-        })
-            .add()
-            .align(buttonOptions.position, false, alignTo);
-    }
-    else {
-        this.drillUpButton.attr({
-            text: backText
-        })
-            .align();
+/**
+ * This method creates an array of arrays containing a level number
+ * with the corresponding series/point.
+ *
+ * @requires  modules/breadcrumbs
+ *
+ * @private
+ * @param {Highcharts.Chart} chart
+ *        Highcharts Chart object.
+ * @return {Array<Breadcrumbs.BreadcrumbOptions>}
+ *        List for Highcharts Breadcrumbs.
+ */
+var createBreadcrumbsList = function (chart) {
+    var list = [], drilldownLevels = chart.drilldownLevels;
+    // The list is based on drilldown levels from the chart object
+    if (drilldownLevels && drilldownLevels.length) {
+        // Add the initial series as the first element.
+        if (!list[0]) {
+            list.push({
+                level: 0,
+                levelOptions: drilldownLevels[0].seriesOptions
+            });
+        }
+        var lastBreadcrumb_1 = list[list.length - 1];
+        drilldownLevels.forEach(function (level) {
+            // If level is already added to breadcrumbs list,
+            // don't add it again- drilling categories
+            // + 1 because of the wrong levels numeration
+            // in drilldownLevels array.
+            if (level.levelNumber + 1 > lastBreadcrumb_1.level) {
+                list.push({
+                    level: level.levelNumber + 1,
+                    levelOptions: merge({
+                        name: level.lowerSeries.name
+                    }, level.pointOptions)
+                });
+            }
+        });
     }
+    return list;
 };
 /**
  * When the chart is drilled down to a child series, calling `chart.drillUp()`
@@ -630,6 +654,7 @@ Chart.prototype.drillUp = function () {
     if (!this.drilldownLevels || this.drilldownLevels.length === 0) {
         return;
     }
+    fireEvent(this, 'beforeDrillUp');
     var chart = this, drilldownLevels = chart.drilldownLevels, levelNumber = drilldownLevels[drilldownLevels.length - 1].levelNumber, i = drilldownLevels.length, chartSeries = chart.series, seriesI, level, oldSeries, newSeries, oldExtremes, addSeries = function (seriesOptions) {
         var addedSeries;
         chartSeries.forEach(function (series) {
@@ -646,6 +671,7 @@ Chart.prototype.drillUp = function () {
             newSeries = addedSeries;
         }
     };
+    var drilldownLevelsNumber = chart.drilldownLevels.length;
     while (i--) {
         level = drilldownLevels[i];
         if (level.levelNumber === levelNumber) {
@@ -665,12 +691,19 @@ Chart.prototype.drillUp = function () {
                 }
             }
             oldSeries.xData = []; // Overcome problems with minRange (#2898)
+            // Reset the names to start new series from the beginning.
+            // Do it once to preserve names when multiple
+            // series are added for the same axis, #16135.
+            if (oldSeries.xAxis &&
+                oldSeries.xAxis.names &&
+                (drilldownLevelsNumber === 0 || i === drilldownLevelsNumber)) {
+                oldSeries.xAxis.names.length = 0;
+            }
             level.levelSeriesOptions.forEach(addSeries);
             fireEvent(chart, 'drillup', {
                 seriesOptions: level.seriesPurgedOptions ||
                     level.seriesOptions
             });
-            this.resetZoomButton && this.resetZoomButton.destroy(); // #8095
             if (newSeries.type === oldSeries.type) {
                 newSeries.drilldownLevel = level;
                 newSeries.options.animation =
@@ -691,30 +724,46 @@ Chart.prototype.drillUp = function () {
             // it to the chart and show it.
             if (level.resetZoomButton) {
                 chart.resetZoomButton = level.resetZoomButton;
-                chart.resetZoomButton.show();
             }
         }
     }
+    fireEvent(chart, 'afterDrillUp');
     this.redraw();
-    if (this.drilldownLevels.length === 0) {
-        this.drillUpButton = this.drillUpButton.destroy();
-    }
-    else {
-        this.drillUpButton.attr({
-            text: this.getDrilldownBackText()
-        })
-            .align();
-    }
     this.ddDupes.length = []; // #3315
     // Fire a once-off event after all series have been drilled up (#5158)
     fireEvent(chart, 'drillupall');
 };
+/**
+ * A function to fade in a group. First, the element is being hidden,
+ * then, using `opactiy`, is faded in. Used for example by `dataLabelsGroup`
+ * where simple SVGElement.fadeIn() is not enough, because of other features
+ * (e.g. InactiveState) using `opacity` to fadeIn/fadeOut.
+ *
+ * @requires module:modules/drilldown
+ *
+ * @param {undefined|SVGElement} [group]
+ * The SVG element to be faded in.
+ */
+function fadeInGroup(group) {
+    var animationOptions = animObject(this.chart.options.drilldown.animation);
+    if (group) {
+        group.hide();
+        syncTimeout(function () {
+            // Make sure neither the group, or the chart, were destroyed
+            if (group && group.added) {
+                group.fadeIn();
+            }
+        }, Math.max(animationOptions.duration - 50, 0));
+    }
+}
 /* eslint-disable no-invalid-this */
 // Add update function to be called internally from Chart.update
 // (#7600, #12855)
 addEvent(Chart, 'afterInit', function () {
     var chart = this;
     chart.drilldown = {
+        chart: chart,
+        fadeInGroup: fadeInGroup,
         update: function (options, redraw) {
             merge(true, chart.options.drilldown, options);
             if (pick(redraw, true)) {
@@ -723,17 +772,6 @@ addEvent(Chart, 'afterInit', function () {
         }
     };
 });
-// Shift the drillUpButton to make the space for resetZoomButton, #8095.
-addEvent(Chart, 'afterShowResetZoom', function () {
-    var chart = this, bbox = chart.resetZoomButton && chart.resetZoomButton.getBBox(), buttonOptions = chart.options.drilldown && chart.options.drilldown.drillUpButton;
-    if (this.drillUpButton && bbox && buttonOptions && buttonOptions.position && buttonOptions.position.x) {
-        this.drillUpButton.align({
-            x: buttonOptions.position.x - bbox.width - 10,
-            y: buttonOptions.position.y,
-            align: buttonOptions.position.align
-        }, false, buttonOptions.relativeTo || 'plotBox');
-    }
-});
 addEvent(Chart, 'render', function () {
     (this.xAxis || []).forEach(function (axis) {
         axis.ddPoints = {};
@@ -764,6 +802,31 @@ addEvent(Chart, 'render', function () {
         objectEach(axis.ticks, Tick.prototype.drillable);
     });
 });
+addEvent(H.Breadcrumbs, 'up', function (e) {
+    var chart = this.chart, drillUpsNumber = this.getLevel() - e.newLevel;
+    for (var i = 0; i < drillUpsNumber; i++) {
+        chart.drillUp();
+    }
+});
+addEvent(Chart, 'afterDrilldown', function () {
+    var chart = this, drilldownOptions = chart.options.drilldown, breadcrumbsOptions = drilldownOptions && drilldownOptions.breadcrumbs;
+    if (!chart.breadcrumbs) {
+        chart.breadcrumbs = new Breadcrumbs(chart, breadcrumbsOptions);
+    }
+    chart.breadcrumbs.updateProperties(createBreadcrumbsList(chart));
+});
+addEvent(Chart, 'afterDrillUp', function () {
+    var chart = this;
+    chart.breadcrumbs &&
+        chart.breadcrumbs.updateProperties(createBreadcrumbsList(chart));
+});
+addEvent(Chart, 'update', function (e) {
+    var breadcrumbs = this.breadcrumbs, breadcrumbOptions = e.options.drilldown &&
+        e.options.drilldown.breadcrumbs;
+    if (breadcrumbs && breadcrumbOptions) {
+        breadcrumbs.update(e.options.drilldown.breadcrumbs);
+    }
+});
 /**
  * When drilling up, keep the upper series invisible until the lower series has
  * moved into place.
@@ -849,10 +912,10 @@ ColumnSeries.prototype.animateDrilldown = function (init) {
                     .attr(animateFrom)
                     .animate(extend(point.shapeArgs, { fill: point.color || series.color }), animationOptions);
             }
-            if (point.dataLabel) {
-                point.dataLabel.fadeIn(animationOptions);
-            }
         });
+        if (chart.drilldown) {
+            chart.drilldown.fadeInGroup(this.dataLabelsGroup);
+        }
         // Reset to prototype
         delete this.animate;
     }
@@ -930,6 +993,9 @@ if (PieSeries) {
                             }))[animationOptions ? 'animate' : 'attr'](animateTo, animationOptions);
                         }
                     });
+                    if (this.chart.drilldown) {
+                        this.chart.drilldown.fadeInGroup(this.dataLabelsGroup);
+                    }
                     // Reset to prototype
                     delete this.animate;
                 }
@@ -1145,21 +1211,13 @@ addEvent(Point, 'afterSetState', function () {
         applyCursorCSS(this.series.halo, 'auto', false, styledMode);
     }
 });
-// After zooming out, shift the drillUpButton to the previous position, #8095.
-addEvent(Chart, 'selection', function (event) {
-    if (event.resetSelection === true && this.drillUpButton) {
-        var buttonOptions = this.options.drilldown && this.options.drilldown.drillUpButton;
-        if (buttonOptions && buttonOptions.position) {
-            this.drillUpButton.align({
-                x: buttonOptions.position.x,
-                y: buttonOptions.position.y,
-                align: buttonOptions.position.align
-            }, false, buttonOptions.relativeTo || 'plotBox');
-        }
-    }
-});
 addEvent(Chart, 'drillup', function () {
     if (this.resetZoomButton) {
         this.resetZoomButton = this.resetZoomButton.destroy();
     }
 });
+addEvent(Chart, 'drillupall', function () {
+    if (this.resetZoomButton) {
+        this.showResetZoom();
+    }
+});

package/es-modules/Extensions/ExportData.js

@@ -338,7 +338,7 @@ Chart.prototype.setUpKeyToAxis = function () {
  * @return {Array<Array<(number|string)>>}
  *         The current chart data
  *
- * @fires Highcharts.Chart#event:exportData
+ * @emits Highcharts.Chart#event:exportData
  */
 Chart.prototype.getDataRows = function (multiLevelHeaders) {
     var hasParallelCoords = this.hasParallelCoordinates, time = this.time, csvOptions = ((this.options.exporting && this.options.exporting.csv) || {}), xAxis, xAxes = this.xAxis, rows = {}, rowArr = [], dataRows, topLevelColumnTitles = [], columnTitles = [], columnTitleObj, i, x, xTitle, langOptions = this.options.lang, exportDataOptions = langOptions.exportData, categoryHeader = exportDataOptions.categoryHeader, categoryDatetimeHeader = exportDataOptions.categoryDatetimeHeader, 
@@ -397,7 +397,8 @@ Chart.prototype.getDataRows = function (multiLevelHeaders) {
             !xAxis.categories &&
             !series.keyToAxis) {
             if (series.pointArrayMap) {
-                var pointArrayMapCheck = series.pointArrayMap.filter(function (p) { return p === 'x'; });
+                var pointArrayMapCheck = series.pointArrayMap
+                    .filter(function (p) { return p === 'x'; });
                 if (pointArrayMapCheck.length) {
                     series.pointArrayMap.unshift('x');
                     return series.pointArrayMap;
@@ -613,7 +614,7 @@ Chart.prototype.getCSV = function (useLocalDecimalPoint) {
  * @return {string}
  *         HTML representation of the data.
  *
- * @fires Highcharts.Chart#event:afterGetTable
+ * @emits Highcharts.Chart#event:afterGetTable
  */
 Chart.prototype.getTable = function (useLocalDecimalPoint) {
     var serialize = function (node) {
@@ -905,7 +906,7 @@ Chart.prototype.downloadXLS = function () {
  *
  * @function Highcharts.Chart#viewData
  *
- * @fires Highcharts.Chart#event:afterViewData
+ * @emits Highcharts.Chart#event:afterViewData
  */
 Chart.prototype.viewData = function () {
     this.toggleDataTable(true);
@@ -932,7 +933,7 @@ Chart.prototype.toggleDataTable = function (show) {
         this.dataTableDiv.style.display = show ? 'block' : 'none';
         // Generate the data table
         if (show) {
-            this.dataTableDiv.innerHTML = '';
+            this.dataTableDiv.innerHTML = AST.emptyHTML;
             var ast = new AST([this.getTableAST()]);
             ast.addToDOM(this.dataTableDiv);
             fireEvent(this, 'afterViewData', this.dataTableDiv);

package/es-modules/Extensions/Exporting/Exporting.js

@@ -87,7 +87,6 @@ var Exporting;
      * @private
      * @function Highcharts.Chart#addButton
      * @param {Highcharts.NavigationButtonOptions} options
-     * @return {void}
      * @requires modules/exporting
      */
     function addButton(options) {
@@ -192,9 +191,8 @@ var Exporting;
      *
      * @param {Highcharts.Chart} chart
      *        Chart that was (or suppose to be) printed
-     * @return {void}
      *
-     * @fires Highcharts.Chart#event:afterPrint
+     * @emits Highcharts.Chart#event:afterPrint
      */
     function afterPrint() {
         var chart = this;
@@ -226,9 +224,8 @@ var Exporting;
      *
      * @private
      *
-     * @return {void}
      *
-     * @fires Highcharts.Chart#event:beforePrint
+     * @emits Highcharts.Chart#event:beforePrint
      */
     function beforePrint() {
         var chart = this, body = doc.body, printMaxWidth = chart.options.exporting.printMaxWidth, printReverseInfo = {
@@ -240,7 +237,8 @@ var Exporting;
         chart.pointer.reset(null, 0);
         fireEvent(chart, 'beforePrint');
         // Handle printMaxWidth
-        var handleMaxWidth = printMaxWidth && chart.chartWidth > printMaxWidth;
+        var handleMaxWidth = printMaxWidth &&
+            chart.chartWidth > printMaxWidth;
         if (handleMaxWidth) {
             printReverseInfo.resetParams = [
                 chart.options.chart.width,
@@ -363,7 +361,6 @@ var Exporting;
      *        The width of the opener button
      * @param {number} height
      *        The height of the opener button
-     * @return {void}
      * @requires modules/exporting
      */
     function contextMenu(className, items, x, y, width, height, button) {
@@ -436,9 +433,10 @@ var Exporting;
                         element = createElement('hr', void 0, void 0, innerMenu);
                     }
                     else {
-                        // When chart initialized with the table,
-                        // wrong button text displayed, #14352.
-                        if (item.textKey === 'viewData' && chart.isDataTableVisible) {
+                        // When chart initialized with the table, wrong button
+                        // text displayed, #14352.
+                        if (item.textKey === 'viewData' &&
+                            chart.isDataTableVisible) {
                             item.textKey = 'hideData';
                         }
                         element = createElement('li', {
@@ -465,7 +463,7 @@ var Exporting;
                             };
                             css(element, extend({
                                 cursor: 'pointer'
-                            }, navOptions.menuItemStyle));
+                            }, navOptions.menuItemStyle || {}));
                         }
                     }
                     // Keep references to menu divs to be able to destroy them
@@ -506,7 +504,6 @@ var Exporting;
      * @private
      * @function Highcharts.Chart#destroyExport
      * @param {global.Event} [e]
-     * @return {void}
      * @requires modules/exporting
      */
     function destroyExport(e) {
@@ -609,8 +606,8 @@ var Exporting;
      *
      * @function Highcharts.Chart#getChartHTML
      *
-     * @returns {string}
-     *          The unfiltered SVG of the chart.
+     * @return {string}
+     * The unfiltered SVG of the chart.
      *
      * @requires modules/exporting
      */
@@ -669,7 +666,7 @@ var Exporting;
      * @return {string}
      *         The SVG representation of the rendered chart.
      *
-     * @fires Highcharts.Chart#event:getSVG
+     * @emits Highcharts.Chart#event:getSVG
      *
      * @requires modules/exporting
      */
@@ -777,10 +774,6 @@ var Exporting;
     /**
      * @private
      * @function Highcharts.Chart#getSVGForExport
-     * @param {Highcharts.ExportingOptions} options
-     * @param {Highcharts.Options} chartOptions
-     * @return {string}
-     * @requires modules/exporting
      */
     function getSVGForExport(options, chartOptions) {
         var chartExportingOptions = this.options.exporting;
@@ -797,9 +790,9 @@ var Exporting;
      * Make hyphenated property names out of camelCase
      * @private
      * @param {string} prop
-     *        Property name in camelCase
+     * Property name in camelCase
      * @return {string}
-     *         Hyphenated property name
+     * Hyphenated property name
      */
     function hyphenate(prop) {
         return prop.replace(/([A-Z])/g, function (a, b) {
@@ -811,11 +804,11 @@ var Exporting;
      *
      * @private
      * @function Highcharts.Chart#inlineStyles
-     * @return {void}
      *
-     * @todo: What are the border styles for text about? In general, text has a
-     * lot of properties.
-     * @todo: Make it work with IE9 and IE10.
+     * @todo What are the border styles for text about? In general, text has a
+     *       lot of properties.
+     *
+     * @todo Make it work with IE9 and IE10.
      *
      * @requires modules/exporting
      */
@@ -841,8 +834,7 @@ var Exporting;
          * @private
          * @param {Highcharts.HTMLDOMElement} node
          *        Element child
-         * @return {void}
-         */
+             */
         function recurse(node) {
             var styles, parentStyles, cssText = '', dummy, styleAttr, blacklisted, whitelisted, i;
             /**
@@ -853,8 +845,7 @@ var Exporting;
              *        Style value
              * @param {string} prop
              *        Style property name
-             * @return {void}
-             */
+                     */
             function filterStyles(val, prop) {
                 // Check against whitelist & blacklist
                 blacklisted = whitelisted = false;
@@ -926,15 +917,17 @@ var Exporting;
                     dummySVG.removeChild(dummy);
                 }
                 // Loop through all styles and add them inline if they are ok
-                if (G.isFirefox || G.isMS) {
-                    // Some browsers put lots of styles on the prototype
-                    for (var p in styles) { // eslint-disable-line guard-for-in
+                for (var p in styles) {
+                    if (
+                    // Some browsers put lots of styles on the prototype...
+                    G.isFirefox ||
+                        G.isMS ||
+                        G.isSafari || // #16902
+                        // ... Chrome puts them on the instance
+                        Object.hasOwnProperty.call(styles, p)) {
                         filterStyles(styles[p], p);
                     }
                 }
-                else {
-                    objectEach(styles, filterStyles);
-                }
                 // Apply styles
                 if (cssText) {
                     styleAttr = node.getAttribute('style');
@@ -954,8 +947,7 @@ var Exporting;
         /**
          * Remove the dummy objects used to get defaults
          * @private
-         * @return {void}
-         */
+             */
         function tearDown() {
             dummySVG.parentNode.removeChild(dummySVG);
             // Remove trash from DOM that stayed after each exporting
@@ -973,7 +965,6 @@ var Exporting;
      *
      * @param {Highcharts.HTMLDOMElement} moveTo
      *        Move target
-     * @return {void}
      */
     function moveContainers(moveTo) {
         var chart = this;
@@ -1000,8 +991,7 @@ var Exporting;
          *        Options to update
          * @param {boolean} [redraw=true]
          *        Whether to redraw
-         * @return {void}
-         */
+                 */
         update = function (prop, options, redraw) {
             chart.isDirtyExporting = true;
             merge(true, chart.options[prop], options);
@@ -1034,10 +1024,9 @@ var Exporting;
      *
      * @function Highcharts.Chart#print
      *
-     * @return {void}
      *
-     * @fires Highcharts.Chart#event:beforePrint
-     * @fires Highcharts.Chart#event:afterPrint
+     * @emits Highcharts.Chart#event:beforePrint
+     * @emits Highcharts.Chart#event:afterPrint
      *
      * @requires modules/exporting
      */
@@ -1067,7 +1056,6 @@ var Exporting;
      * Add the buttons on chart load
      * @private
      * @function Highcharts.Chart#renderExporting
-     * @return {void}
      * @requires modules/exporting
      */
     function renderExporting() {