highcharts 6.1.1 → 6.2.0

package/js/highcharts-more.src.js

@@ -1,5 +1,5 @@
 /**
- * @license Highcharts JS v6.1.1 (2018-06-27)
+ * @license Highcharts JS v6.2.0 (2018-10-17)
  *
  * (c) 2009-2016 Torstein Honsi
  *
@@ -9,13 +9,17 @@
 (function (factory) {
 	if (typeof module === 'object' && module.exports) {
 		module.exports = factory;
+	} else if (typeof define === 'function' && define.amd) {
+		define(function () {
+			return factory;
+		});
 	} else {
 		factory(Highcharts);
 	}
 }(function (Highcharts) {
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -139,6 +143,7 @@
 		     * The pane serves as a container for axes and backgrounds for circular
 		     * gauges and polar charts.
 		     * @since 2.3.0
+		     * @product highcharts
 		     * @optionparent pane
 		     */
 		    defaultOptions: {
@@ -215,7 +220,7 @@
 		         */
 
 		        /**
-		         * Tha shape of the pane background. When `solid`, the background
+		         * The shape of the pane background. When `solid`, the background
 		         * is circular. When `arc`, the background extends only from the min
 		         * to the max of the value axis.
 		         *
@@ -302,7 +307,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -715,9 +720,10 @@
 		            // Concentric circles
 		            } else if (axis.options.gridLineInterpolation === 'circle') {
 		                value = axis.translate(value);
-		                if (value) { // a value of 0 is in the center
-		                    ret = axis.getLinePath(0, value);
-		                }
+
+		                // a value of 0 is in the center, so it won't be visible,
+		                // but draw it anyway for update and animation (#2366)
+		                ret = axis.getLinePath(0, value);
 		            // Concentric polygons
 		            } else {
 		                // Find the X axis in the same pane
@@ -986,13 +992,15 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
 		var each = H.each,
 		    noop = H.noop,
 		    pick = H.pick,
+		    extend = H.extend,
+		    isArray = H.isArray,
 		    defined = H.defined,
 		    Series = H.Series,
 		    seriesType = H.seriesType,
@@ -1102,7 +1110,6 @@
 		// Prototype members
 		}, {
 		    pointArrayMap: ['low', 'high'],
-		    dataLabelCollections: ['dataLabel', 'dataLabelUpper'],
 		    toYData: function (point) {
 		        return [point.low, point.high];
 		    },
@@ -1290,31 +1297,55 @@
 		     */
 		    drawDataLabels: function () {
 
-		        var data = this.data,
+		        var data = this.points,
 		            length = data.length,
 		            i,
 		            originalDataLabels = [],
 		            dataLabelOptions = this.options.dataLabels,
-		            align = dataLabelOptions.align,
-		            verticalAlign = dataLabelOptions.verticalAlign,
-		            inside = dataLabelOptions.inside,
 		            point,
 		            up,
-		            inverted = this.chart.inverted;
-
-		        if (dataLabelOptions.enabled || this._hasPointLabels) {
+		            inverted = this.chart.inverted,
+		            upperDataLabelOptions,
+		            lowerDataLabelOptions;
+
+		        // Split into upper and lower options. If data labels is an array, the
+		        // first element is the upper label, the second is the lower.
+		        //
+		        // TODO: We want to change this and allow multiple labels for both upper
+		        // and lower values in the future - introducing some options for which
+		        // point value to use as Y for the dataLabel, so that this could be
+		        // handled in Series.drawDataLabels. This would also improve performance
+		        // since we now have to loop over all the points multiple times to work
+		        // around the data label logic.
+		        if (isArray(dataLabelOptions)) {
+		            if (dataLabelOptions.length > 1) {
+		                upperDataLabelOptions = dataLabelOptions[0];
+		                lowerDataLabelOptions = dataLabelOptions[1];
+		            } else {
+		                upperDataLabelOptions = dataLabelOptions[0];
+		                lowerDataLabelOptions = { enabled: false };
+		            }
+		        } else {
+		            upperDataLabelOptions = extend({}, dataLabelOptions); // Make copy;
+		            upperDataLabelOptions.x = dataLabelOptions.xHigh;
+		            upperDataLabelOptions.y = dataLabelOptions.yHigh;
+		            lowerDataLabelOptions = extend({}, dataLabelOptions); // Make copy
+		            lowerDataLabelOptions.x = dataLabelOptions.xLow;
+		            lowerDataLabelOptions.y = dataLabelOptions.yLow;
+		        }
 
-		            // Step 1: set preliminary values for plotY and dataLabel
+		        // Draw upper labels
+		        if (upperDataLabelOptions.enabled || this._hasPointLabels) {
+		            // Set preliminary values for plotY and dataLabel
 		            // and draw the upper labels
 		            i = length;
 		            while (i--) {
 		                point = data[i];
 		                if (point) {
-		                    up = inside ?
+		                    up = upperDataLabelOptions.inside ?
 		                        point.plotHigh < point.plotLow :
 		                        point.plotHigh > point.plotLow;
 
-		                    // Set preliminary values
 		                    point.y = point.high;
 		                    point._plotY = point.plotY;
 		                    point.plotY = point.plotHigh;
@@ -1327,70 +1358,87 @@
 		                    // Set the default offset
 		                    point.below = up;
 		                    if (inverted) {
-		                        if (!align) {
-		                            dataLabelOptions.align = up ? 'right' : 'left';
+		                        if (!upperDataLabelOptions.align) {
+		                            upperDataLabelOptions.align = up ? 'right' : 'left';
 		                        }
 		                    } else {
-		                        if (!verticalAlign) {
-		                            dataLabelOptions.verticalAlign = up ?
+		                        if (!upperDataLabelOptions.verticalAlign) {
+		                            upperDataLabelOptions.verticalAlign = up ?
 		                                'top' :
 		                                'bottom';
 		                        }
 		                    }
-
-		                    dataLabelOptions.x = dataLabelOptions.xHigh;
-		                    dataLabelOptions.y = dataLabelOptions.yHigh;
 		                }
 		            }
 
+		            this.options.dataLabels = upperDataLabelOptions;
+
 		            if (seriesProto.drawDataLabels) {
 		                seriesProto.drawDataLabels.apply(this, arguments); // #1209
 		            }
 
-		            // Step 2: reorganize and handle data labels for the lower values
+		            // Reset state after the upper labels were created. Move
+		            // it to point.dataLabelUpper and reassign the originals.
+		            // We do this here to support not drawing a lower label.
 		            i = length;
 		            while (i--) {
 		                point = data[i];
 		                if (point) {
-		                    up = inside ?
-		                        point.plotHigh < point.plotLow :
-		                        point.plotHigh > point.plotLow;
-
-		                    // Move the generated labels from step 1, and reassign
-		                    // the original data labels
 		                    point.dataLabelUpper = point.dataLabel;
 		                    point.dataLabel = originalDataLabels[i];
-
-		                    // Reset values
+		                    delete point.dataLabels;
 		                    point.y = point.low;
 		                    point.plotY = point._plotY;
+		                }
+		            }
+		        }
+
+		        // Draw lower labels
+		        if (lowerDataLabelOptions.enabled || this._hasPointLabels) {
+		            i = length;
+		            while (i--) {
+		                point = data[i];
+		                if (point) {
+		                    up = lowerDataLabelOptions.inside ?
+		                        point.plotHigh < point.plotLow :
+		                        point.plotHigh > point.plotLow;
 
 		                    // Set the default offset
 		                    point.below = !up;
 		                    if (inverted) {
-		                        if (!align) {
-		                            dataLabelOptions.align = up ? 'left' : 'right';
+		                        if (!lowerDataLabelOptions.align) {
+		                            lowerDataLabelOptions.align = up ? 'left' : 'right';
 		                        }
 		                    } else {
-		                        if (!verticalAlign) {
-		                            dataLabelOptions.verticalAlign = up ?
+		                        if (!lowerDataLabelOptions.verticalAlign) {
+		                            lowerDataLabelOptions.verticalAlign = up ?
 		                                'bottom' :
 		                                'top';
 		                        }
-
 		                    }
-
-		                    dataLabelOptions.x = dataLabelOptions.xLow;
-		                    dataLabelOptions.y = dataLabelOptions.yLow;
 		                }
 		            }
+
+		            this.options.dataLabels = lowerDataLabelOptions;
+
 		            if (seriesProto.drawDataLabels) {
 		                seriesProto.drawDataLabels.apply(this, arguments);
 		            }
 		        }
 
-		        dataLabelOptions.align = align;
-		        dataLabelOptions.verticalAlign = verticalAlign;
+		        // Merge upper and lower into point.dataLabels for later destroying
+		        if (upperDataLabelOptions.enabled) {
+		            i = length;
+		            while (i--) {
+		                point = data[i];
+		                if (point && point.dataLabelUpper) {
+		                    point.dataLabels = [point.dataLabelUpper, point.dataLabel];
+		                }
+		            }
+		        }
+
+		        // Reset options
+		        this.options.dataLabels = dataLabelOptions;
 		    },
 
 		    alignDataLabel: function () {
@@ -1590,8 +1638,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 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.arearange.turboThreshold),
 		 * this option is not available.
@@ -1654,7 +1702,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -1711,8 +1759,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 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.areasplinerange.turboThreshold), this option is not available.
 		 *
@@ -1751,7 +1799,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -1961,8 +2009,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 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.columnrange.turboThreshold), this option is not available.
 		 *
@@ -2014,7 +2062,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -2484,8 +2532,8 @@
 		 *  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.gauge.turboThreshold),
 		 * this option is not available.
 		 *
@@ -2522,7 +2570,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -2814,8 +2862,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 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.boxplot.turboThreshold),
 		 * this option is not available.
 		 *
@@ -2905,7 +2953,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -2920,7 +2968,9 @@
 		 * measurement.
 		 *
 		 * @sample       highcharts/demo/error-bar/
-		 *               Error bars
+		 *               Error bars on a column series
+		 * @sample       highcharts/series-errorbar/on-scatter/
+		 *               Error bars on a scatter series
 		 * @extends      {plotOptions.boxplot}
 		 * @product      highcharts highstock
 		 * @optionparent plotOptions.errorbar
@@ -3018,8 +3068,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 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.errorbar.turboThreshold),
 		 * this option is not available.
 		 *
@@ -3059,7 +3109,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -3226,6 +3276,8 @@
 		                previousY += stack && stack[point.x] ?
 		                    stack[point.x].total :
 		                    yValue;
+
+		                point.below = previousY < pick(threshold, 0);
 		            }
 
 		            // #3952 Negative sum or intermediate sum not rendered correctly
@@ -3250,6 +3302,9 @@
 		                    point.minPointLengthOffset = halfMinPointLength;
 		                }
 		            } else {
+		                if (point.isNull) {
+		                    shapeArgs.width = 0;
+		                }
 		                point.minPointLengthOffset = 0;
 		            }
 
@@ -3380,7 +3435,7 @@
 		    },
 
 		    /**
-		     * The graph is initally drawn with an empty definition, then updated with
+		     * The graph is initially drawn with an empty definition, then updated with
 		     * crisp rendering.
 		     */
 		    drawGraph: function () {
@@ -3484,8 +3539,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 3.  An array of objects with named values. The objects are point
-		 * configuration objects as seen below. If the total number of data
+		 * 3.  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.waterfall.turboThreshold),
 		 * this option is not available.
@@ -3548,7 +3603,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -3654,8 +3709,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 3.  An array of objects with named values. The objects are point
-		 * configuration objects as seen below. If the total number of data
+		 * 3.  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.polygon.turboThreshold),
 		 * this option is not available.
 		 *
@@ -3692,7 +3747,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */
@@ -4213,9 +4268,14 @@
 		        }
 		    });
 
+		    // Apply the padding to the min and max properties
 		    if (activeSeries.length && range > 0 && !this.isLog) {
 		        pxMax -= axisLength;
-		        transA *= (axisLength + pxMin - pxMax) / axisLength;
+		        transA *= (
+		            axisLength +
+		            Math.max(0, pxMin) - // #8901
+		            Math.min(pxMax, axisLength)
+		        ) / axisLength;
 		        each(
 		            [['min', 'userMin', pxMin], ['max', 'userMax', pxMax]],
 		            function (keys) {
@@ -4259,8 +4319,8 @@
 		 *     ]
 		 *  ```
 		 *
-		 * 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.bubble.turboThreshold),
 		 * this option is not available.
 		 *
@@ -4315,7 +4375,7 @@
 	}(Highcharts));
 	(function (H) {
 		/**
-		 * (c) 2010-2017 Torstein Honsi
+		 * (c) 2010-2018 Torstein Honsi
 		 *
 		 * License: www.highcharts.com/license
 		 */