highcharts 6.1.1 → 6.2.0

package/es-modules/modules/drilldown.src.js

@@ -59,6 +59,7 @@ extend(defaultOptions.lang, {
  * ](code.highcharts.com/modules/drilldown.js).
  *
  * @type {Object}
+ * @product highcharts highstock highmaps
  * @optionparent drilldown
  */
 defaultOptions.drilldown = {
@@ -153,12 +154,12 @@ defaultOptions.drilldown = {
      * <dt>easing</dt>
      *
      * <dd>A string reference to an easing function set on the `Math` object.
-     * See [the easing demo](http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/series-
+     * See [the easing demo](https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/series-
      * animation-easing/).</dd>
      *
      * </dl>
      *
-     * @type {Boolean|Object}
+     * @type {Boolean|AnimationOptions}
      * @since 3.0.8
      * @product highcharts highmaps
      */
@@ -236,6 +237,7 @@ defaultOptions.drilldown = {
 
             /**
              * Horizontal alignment.
+             * @validvalue ["left", "center", "right"]
              * @type {String}
              */
             align: 'right',

package/es-modules/modules/export-data.src.js

@@ -1,7 +1,7 @@
 /**
  * Experimental data export module for Highcharts
  *
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -65,8 +65,15 @@ Highcharts.setOptions({
          * export menu and provides functions like `Chart.getCSV`,
          * `Chart.getTable`, `Chart.getDataRows` and `Chart.viewData`.
          *
+         * The XLS converter is limited and only creates a HTML string that is
+         * passed for download, which works but creates a warning before
+         * opening. The workaround for this is to use a third party XLSX
+         * converter, as demonstrated in the sample below.
+         *
          * @sample  highcharts/export-data/categorized/ Categorized data
          * @sample  highcharts/export-data/stock-timeaxis/ Highstock time axis
+         * @sample  highcharts/export-data/xlsx/
+         *          Using a third party XLSX converter
          *
          * @since 6.0.0
          */
@@ -132,6 +139,9 @@ Highcharts.setOptions({
          * the chart's current data.
          *
          * @sample highcharts/export-data/showtable/ Show the table
+         * @sample highcharts/studies/exporting-table-html
+         *         Experiment with putting the table inside the subtitle to
+         *         allow exporting it.
          * @since 6.0.0
          */
         showTable: false,

package/es-modules/modules/exporting.src.js

@@ -1,7 +1,7 @@
 /**
  * Exporting module
  *
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -387,7 +387,7 @@ merge(true, defaultOptions.navigation,
 
 /**
  * Options for the exporting module. For an overview on the matter, see
- * [the docs](http://www.highcharts.com/docs/export-module/export-module-overview).
+ * [the docs](https://www.highcharts.com/docs/export-module/export-module-overview).
  * @type {Object}
  * @optionparent exporting
  */
@@ -657,7 +657,7 @@ defaultOptions.exporting = {
              * the `Highcharts.Renderer.symbols` collection. The default
              * `exportIcon` function is part of the exporting module.
              *
-             * @validvalue ["circle", "square", "diamond", "triangle", "triangle-down", "menu"]
+             * @validvalue ["exportIcon", "circle", "square", "diamond", "triangle", "triangle-down", "menu"]
              * @type {String}
              * @sample highcharts/exporting/buttons-contextbutton-symbol/
              *         Use a circle for symbol
@@ -673,9 +673,19 @@ defaultOptions.exporting = {
              * button's title tooltip. When the key is `contextButtonTitle`, it
              * refers to [lang.contextButtonTitle](#lang.contextButtonTitle)
              * that defaults to "Chart context menu".
-             * @type {String}
+             *
+             * @since 6.1.4
+             */
+            titleKey: 'contextButtonTitle',
+
+            /**
+             * This option is deprecated, use
+             * [titleKey](#exporting.buttons.contextButton.titleKey) instead.
+             *
+             * @deprecated
+             * @type      {string}
+             * @apioption exporting.buttons.contextButton._titleKey
              */
-            _titleKey: 'contextButtonTitle',
 
             /**
              * A collection of strings pointing to config options for the menu
@@ -894,7 +904,6 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
 
         svg = svg
             .replace(/zIndex="[^"]+"/g, '')
-            .replace(/isShadow="[^"]+"/g, '')
             .replace(/symbolName="[^"]+"/g, '')
             .replace(/jQuery[0-9]+="[^"]+"/g, '')
             .replace(/url\(("|")(\S+)("|")\)/g, 'url($2)')
@@ -1193,33 +1202,37 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         // pull out the chart
         body.appendChild(container);
 
-        // print
-        win.focus(); // #1510
-        win.print();
-
-        // allow the browser to prepare before reverting
+        // Give the browser time to draw WebGL content, an issue that randomly
+        // appears (at least) in Chrome ~67 on the Mac (#8708).
         setTimeout(function () {
 
-            // put the chart back in
-            origParent.appendChild(container);
+            win.focus(); // #1510
+            win.print();
 
-            // restore all body content
-            each(childNodes, function (node, i) {
-                if (node.nodeType === 1) {
-                    node.style.display = origDisplay[i];
-                }
-            });
+            // allow the browser to prepare before reverting
+            setTimeout(function () {
 
-            chart.isPrinting = false;
+                // put the chart back in
+                origParent.appendChild(container);
 
-            // Reset printMaxWidth
-            if (handleMaxWidth) {
-                chart.setSize.apply(chart, resetParams);
-            }
+                // 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');
+                fireEvent(chart, 'afterPrint');
 
-        }, 1000);
+            }, 1000);
+        }, 1);
 
     },
 
@@ -1244,14 +1257,14 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
             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', {
+            chart.exportContextMenu = chart[cacheName] = menu =
+            createElement('div', {
                 className: className
             }, {
                 position: 'absolute',
@@ -1277,18 +1290,19 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
             
 
             // hide on mouse out
-            hide = function () {
+            menu.hideMenu = function () {
                 css(menu, { display: 'none' });
                 if (button) {
                     button.setState(0);
                 }
                 chart.openMenu = false;
+                H.clearTimeout(menu.hideTimer);
             };
 
             // Hide the menu some time after mouse leave (#1357)
             chart.exportEvents.push(
                 addEvent(menu, 'mouseleave', function () {
-                    menu.hideTimer = setTimeout(hide, 500);
+                    menu.hideTimer = setTimeout(menu.hideMenu, 500);
                 }),
                 addEvent(menu, 'mouseenter', function () {
                     H.clearTimeout(menu.hideTimer);
@@ -1298,13 +1312,13 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
                 // #2335, #2407)
                 addEvent(doc, 'mouseup', function (e) {
                     if (!chart.pointer.inClass(e.target, className)) {
-                        hide();
+                        menu.hideMenu();
                     }
                 }),
 
                 addEvent(menu, 'click', function () {
                     if (chart.openMenu) {
-                        hide();
+                        menu.hideMenu();
                     }
                 })
             );
@@ -1329,7 +1343,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
                                 if (e) { // IE7
                                     e.stopPropagation();
                                 }
-                                hide();
+                                menu.hideMenu();
                                 if (item.onclick) {
                                     item.onclick.apply(chart, arguments);
                                 }
@@ -1427,12 +1441,19 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
 
         if (onclick) {
             callback = function (e) {
-                e.stopPropagation();
+                if (e) {
+                    e.stopPropagation();
+                }
                 onclick.call(chart, e);
             };
 
         } else if (menuItems) {
-            callback = function () {
+            callback = function (e) {
+                // consistent with onclick call (#3495)
+                if (e) {
+                    e.stopPropagation();
+                }
+
                 chart.contextMenu(
                     button.menuClassName,
                     menuItems,
@@ -1465,7 +1486,12 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
                 
                 'stroke-linecap': 'round',
                 
-                title: pick(chart.options.lang[btnOptions._titleKey], '')
+                title: pick(
+                    chart.options.lang[
+                        btnOptions._titleKey || btnOptions.titleKey
+                    ],
+                    ''
+                )
             });
         button.menuClassName = (
             options.menuClassName ||

package/es-modules/modules/funnel.src.js

@@ -1,7 +1,7 @@
 /**
  * Highcharts funnel module
  *
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -427,8 +427,8 @@ seriesType('funnel', 'pie',
  *  data: [0, 5, 3, 5]
  *  ```
  *
- * 2.  An array of objects with named values. The objects are point
- * configuration objects as seen below. If the total number of data
+ * 2.  An array of objects with named values. The following snippet shows only a
+ * few settings, see the complete options set below. If the total number of data
  * points exceeds the series' [turboThreshold](#series.funnel.turboThreshold),
  * this option is not available.
  *
@@ -527,8 +527,8 @@ seriesType('pyramid', 'funnel',
  *  data: [0, 5, 3, 5]
  *  ```
  *
- * 2.  An array of objects with named values. The objects are point
- * configuration objects as seen below. If the total number of data
+ * 2.  An array of objects with named values. The following snippet shows only a
+ * few settings, see the complete options set below. If the total number of data
  * points exceeds the series' [turboThreshold](#series.pyramid.turboThreshold),
  * this option is not available.
  *

package/es-modules/modules/histogram.src.js

@@ -18,7 +18,8 @@ var each = H.each,
     isNumber = H.isNumber,
     arrayMax = H.arrayMax,
     arrayMin = H.arrayMin,
-    merge = H.merge;
+    merge = H.merge,
+    map = H.map;
 
 /* ***************************************************************************
  *
@@ -50,23 +51,16 @@ var binsNumberFormulas = {
  * @param {number} binWidth - width of the bin
  * @returns {function}
  **/
-function fitToBinLeftClosed(binWidth) {
+function fitToBinLeftClosed(bins) {
     return function (y) {
-        return Math.floor(y / binWidth) * binWidth;
+        var i = 1;
+        while (bins[i] <= y) {
+            i++;
+        }
+        return bins[--i];
     };
 }
 
-/**
- * Identity function - takes a param and returns that param
- * It is used to grouping data with the same values
- *
- * @param {number} y - value
- * @returns {number}
- **/
-function identity(y) {
-    return y;
-}
-
 /**
  * Histogram class
  *
@@ -134,33 +128,41 @@ seriesType('histogram', 'column', {
     derivedData: function (baseData, binsNumber, binWidth) {
         var max = arrayMax(baseData),
             min = arrayMin(baseData),
-            frequencies = {},
+            frequencies = [],
+            bins = {},
             data = [],
             x,
             fitToBin;
 
-        binWidth = this.binWidth = isNumber(binWidth) ?
-            binWidth :
-            (max - min) / binsNumber;
-
-        fitToBin = binWidth ? fitToBinLeftClosed(binWidth) : identity;
+        binWidth = this.binWidth = correctFloat(
+            isNumber(binWidth) ?
+                (binWidth || 1) :
+                (max - min) / binsNumber
+        );
 
         // If binWidth is 0 then max and min are equaled,
         // increment the x with some positive value to quit the loop
-        for (
-            x = fitToBin(min);
-            x <= max;
-            x = correctFloat(x + (binWidth || 1))
-        ) {
-            frequencies[correctFloat(fitToBin((x)))] = 0;
+        for (x = min; x < max; x = correctFloat(x + binWidth)) {
+            frequencies.push(x);
+            bins[x] = 0;
         }
 
+        if (bins[min] !== 0) {
+            frequencies.push(correctFloat(min));
+            bins[correctFloat(min)] = 0;
+        }
+
+        fitToBin = fitToBinLeftClosed(
+            map(frequencies, function (elem) {
+                return parseFloat(elem);
+            }));
+
         each(baseData, function (y) {
             var x = correctFloat(fitToBin(y));
-            frequencies[x]++;
+            bins[x]++;
         });
 
-        objectEach(frequencies, function (frequency, x) {
+        objectEach(bins, function (frequency, x) {
             data.push({
                 x: Number(x),
                 y: frequency,

package/es-modules/modules/item-series.src.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2009-2017 Torstein Honsi
+ * (c) 2009-2018 Torstein Honsi
  *
  * Item series type for Highcharts
  *
@@ -34,7 +34,11 @@ seriesType('item', 'column', {
     drawPoints: function () {
         var series = this,
             renderer = series.chart.renderer,
-            seriesMarkerOptions = this.options.marker;
+            seriesMarkerOptions = this.options.marker,
+            itemPaddingTranslated = this.yAxis.transA *
+                series.options.itemPadding,
+            borderWidth = this.borderWidth,
+            crisp = borderWidth % 2 ? 0.5 : 1;
 
         each(this.points, function (point) {
             var yPos,
@@ -47,8 +51,15 @@ seriesType('item', 'column', {
                     pointMarkerOptions.symbol ||
                     seriesMarkerOptions.symbol
                 ),
+                radius = pick(
+                    pointMarkerOptions.radius,
+                    seriesMarkerOptions.radius
+                ),
                 size,
-                yTop;
+                yTop,
+                isSquare = symbol !== 'rect',
+                x,
+                y;
 
             point.graphics = graphics = point.graphics || {};
             pointAttr = point.pointAttr ?
@@ -69,18 +80,28 @@ seriesType('item', 'column', {
                 yTop = pick(point.stackY, point.y);
                 size = Math.min(
                     point.pointWidth,
-                    (
-                        series.yAxis.transA *
-                        (1 - series.options.itemPadding)
-                    )
+                    series.yAxis.transA - itemPaddingTranslated
                 );
                 for (yPos = yTop; yPos > yTop - point.y; yPos--) {
 
+                    x = point.barX + (
+                        isSquare ?
+                            point.pointWidth / 2 - size / 2 :
+                            0
+                    );
+                    y = series.yAxis.toPixels(yPos, true) +
+                        itemPaddingTranslated / 2;
+
+                    if (series.options.crisp) {
+                        x = Math.round(x) - crisp;
+                        y = Math.round(y) + crisp;
+                    }
                     attr = {
-                        x: point.barX + point.pointWidth / 2 - size / 2,
-                        y: series.yAxis.toPixels(yPos, true) - size / 2,
-                        width: size,
-                        height: size
+                        x: x,
+                        y: y,
+                        width: Math.round(isSquare ? size : point.pointWidth),
+                        height: Math.round(size),
+                        r: radius
                     };
 
                     if (graphics[itemY]) {
@@ -107,3 +128,7 @@ seriesType('item', 'column', {
     }
 });
 
+H.SVGRenderer.prototype.symbols.rect = function (x, y, w, h, options) {
+    return H.SVGRenderer.prototype.symbols.callout(x, y, w, h, options);
+};
+