highcharts 6.1.1 → 6.2.0

package/es-modules/parts-more/AreaRangeSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -11,6 +11,8 @@ import '../parts/Series.js';
 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,
@@ -140,7 +142,6 @@ seriesType('arearange', 'area', {
 // Prototype members
 }, {
     pointArrayMap: ['low', 'high'],
-    dataLabelCollections: ['dataLabel', 'dataLabelUpper'],
     toYData: function (point) {
         return [point.low, point.high];
     },
@@ -328,31 +329,55 @@ seriesType('arearange', 'area', {
      */
     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;
@@ -365,70 +390,87 @@ seriesType('arearange', 'area', {
                     // 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 () {
@@ -628,8 +670,8 @@ seriesType('arearange', 'area', {
  *     ]
  *  ```
  *
- * 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.

package/es-modules/parts-more/AreaSplineRangeSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -60,8 +60,8 @@ seriesType('areasplinerange', 'arearange', null, {
  *     ]
  *  ```
  *
- * 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.
  *

package/es-modules/parts-more/BoxPlotSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -532,8 +532,8 @@ seriesType('boxplot', 'column', {
  *     ]
  *  ```
  *
- * 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.
  *

package/es-modules/parts-more/BubbleSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -548,9 +548,14 @@ Axis.prototype.beforePadding = function () {
         }
     });
 
+    // 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) {
@@ -594,8 +599,8 @@ Axis.prototype.beforePadding = function () {
  *     ]
  *  ```
  *
- * 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.
  *

package/es-modules/parts-more/ColumnRangeSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -212,8 +212,8 @@ seriesType('columnrange', 'arearange', merge(
  *     ]
  *  ```
  *
- * 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.
  *

package/es-modules/parts-more/ErrorBarSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -19,7 +19,9 @@ var each = H.each,
  * 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
@@ -132,8 +134,8 @@ seriesType('errorbar', 'boxplot', {
  *     ]
  *  ```
  *
- * 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.
  *

package/es-modules/parts-more/GaugeSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -592,8 +592,8 @@ seriesType('gauge', 'line', {
  *  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.
  *

package/es-modules/parts-more/Pane.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -131,6 +131,7 @@ extend(Pane.prototype, {
      * 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: {
@@ -207,7 +208,7 @@ extend(Pane.prototype, {
          */
 
         /**
-         * 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.
          *

package/es-modules/parts-more/Polar.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */

package/es-modules/parts-more/PolygonSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -115,8 +115,8 @@ seriesType('polygon', 'scatter', {
  *     ]
  *  ```
  *
- * 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.
  *

package/es-modules/parts-more/RadialAxis.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -418,9 +418,10 @@ if (!H.radialAxisExtended) {
             // 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

package/es-modules/parts-more/WaterfallSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -237,6 +237,8 @@ seriesType('waterfall', 'column', {
                 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
@@ -261,6 +263,9 @@ seriesType('waterfall', 'column', {
                     point.minPointLengthOffset = halfMinPointLength;
                 }
             } else {
+                if (point.isNull) {
+                    shapeArgs.width = 0;
+                }
                 point.minPointLengthOffset = 0;
             }
 
@@ -417,7 +422,7 @@ seriesType('waterfall', 'column', {
     },
 
     /**
-     * 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 () {
@@ -521,8 +526,8 @@ seriesType('waterfall', 'column', {
  *     ]
  *  ```
  *
- * 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.