highcharts 6.1.4 → 6.2.0

package/es-modules/parts/PlotBandSeries.experimental.js

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

package/es-modules/parts/PlotLineOrBand.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -74,6 +74,9 @@ H.PlotLineOrBand.prototype = {
      * @return {Highcharts.PlotLineOrBand|undefined}
      */
     render: function () {
+
+        H.fireEvent(this, 'render');
+
         var plotLine = this,
             axis = plotLine.axis,
             horiz = axis.horiz,
@@ -319,7 +322,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * perimeter of the gauge.
      *
      * @type      {Array<*>}
-     * @product   highcharts highstock
+     * @product   highcharts highstock gantt
      * @apioption xAxis.plotBands
      */
 
@@ -327,7 +330,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * Border color for the plot band. Also requires `borderWidth` to be set.
      *
      * @type      {Highcharts.ColorString}
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.borderColor
      */
 
@@ -336,7 +338,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @default   0
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.borderWidth
      */
 
@@ -358,7 +359,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Plot band on Y axis
      *
      * @type      {Highcharts.ColorString}
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.color
      */
 
@@ -370,7 +370,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Mouse events demonstrated
      *
      * @since     1.2
-     * @product   highcharts highstock
      * @context   PlotLineOrBand
      * @apioption xAxis.plotBands.events
      */
@@ -386,7 +385,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Plot band on Y axis
      *
      * @type      {number}
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.from
      */
 
@@ -399,7 +397,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Remove plot band by id
      *
      * @type      {string}
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.id
      */
 
@@ -414,7 +411,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Plot band on Y axis
      *
      * @type      {number}
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.to
      */
 
@@ -433,14 +429,13 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @since     1.2
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.zIndex
      */
 
     /**
      * Text labels for the plot bands
      *
-     * @product   highcharts highstock
+     * @product   highcharts highstock gantt
      * @apioption xAxis.plotBands.label
      */
 
@@ -456,7 +451,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @type      {string}
      * @default   center
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.label.align
      */
 
@@ -469,7 +463,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @type      {number}
      * @default   0
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.label.rotation
      */
 
@@ -484,7 +477,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {Highcharts.CSSObject}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.label.style
      */
 
@@ -493,7 +485,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {string}
      * @since     2.1
-     * @product   highcharts
      * @apioption xAxis.plotBands.label.text
      */
 
@@ -508,7 +499,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type       {string}
      * @since      2.1
-     * @product    highcharts highstock
      * @validvalue ["center", "left", "right"]
      * @apioption  xAxis.plotBands.label.textAlign
      */
@@ -520,7 +510,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @type      {boolean}
      * @default   false
      * @since     3.0.3
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.label.useHTML
      */
 
@@ -536,7 +525,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @type       {string}
      * @default    top
      * @since      2.1
-     * @product    highcharts highstock
      * @validvalue ["bottom", "middle",  "top"]
      * @apioption  xAxis.plotBands.label.verticalAlign
      */
@@ -552,7 +540,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.label.x
      */
 
@@ -567,7 +554,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotBands.label.y
      */
 
@@ -579,7 +565,7 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * `.highcharts-plot-line` class in addition to the `className` option.
      *
      * @type      {Array<*>}
-     * @product   highcharts highstock
+     * @product   highcharts highstock gantt
      * @apioption xAxis.plotLines
      */
 
@@ -601,7 +587,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Plot line on Y axis
      *
      * @type      {Highcharts.ColorString}
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.color
      */
 
@@ -619,7 +604,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @type       {string}
      * @default    Solid
      * @since      1.2
-     * @product    highcharts highstock
      * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
      *             "ShortDashDotDot", "Dot", "Dash" ,"LongDash", "DashDot",
      *             "LongDashDot", "LongDashDotDot"]
@@ -635,7 +619,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {*}
      * @since     1.2
-     * @product   highcharts highstock
      * @context   PlotLineOrBand
      * @apioption xAxis.plotLines.events
      */
@@ -647,7 +630,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Remove plot line by id
      *
      * @type      {string}
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.id
      */
 
@@ -660,7 +642,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Plot line on Y axis
      *
      * @type      {number}
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.value
      */
 
@@ -673,7 +654,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *         Plot line on Y axis
      *
      * @type      {number}
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.width
      */
 
@@ -689,14 +669,12 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @since     1.2
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.zIndex
      */
 
     /**
      * Text labels for the plot bands
      *
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.label
      */
 
@@ -712,7 +690,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @type       {string}
      * @default    left
      * @since      2.1
-     * @product    highcharts highstock
      * @validvalue ["center", "left", "right"]
      * @apioption  xAxis.plotLines.label.align
      */
@@ -726,7 +703,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.label.rotation
      */
 
@@ -741,7 +717,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {Highcharts.CSSObject}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.label.style
      */
 
@@ -750,7 +725,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {string}
      * @since     2.1
-     * @product   highcharts
      * @apioption xAxis.plotLines.label.text
      */
 
@@ -765,7 +739,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {string}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.label.textAlign
      */
 
@@ -776,7 +749,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @type      {boolean}
      * @default   false
      * @since     3.0.3
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.label.useHTML
      */
 
@@ -791,7 +763,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      * @default    {highcharts} top
      * @default    {highstock} top
      * @since      2.1
-     * @product    highcharts highstock
      * @validvalue ["top", "middle", "bottom"]
      * @apioption  xAxis.plotLines.label.verticalAlign
      */
@@ -807,7 +778,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.label.x
      */
 
@@ -822,7 +792,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {number}
      * @since     2.1
-     * @product   highcharts highstock
      * @apioption xAxis.plotLines.label.y
      */
 
@@ -831,7 +800,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {Array<*>}
      * @extends   xAxis.plotBands
-     * @product   highcharts highstock
      * @apioption yAxis.plotBands
      */
 
@@ -888,7 +856,6 @@ H.extend(Axis.prototype, /** @lends Highcharts.Axis.prototype */ {
      *
      * @type      {Array<*>}
      * @extends   xAxis.plotLines
-     * @product   highcharts highstock
      * @apioption yAxis.plotLines
      */
 

package/es-modules/parts/Point.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -48,7 +48,6 @@ import './Utilities.js';
 
 var Point,
     H = Highcharts,
-
     each = H.each,
     extend = H.extend,
     erase = H.erase,
@@ -57,6 +56,8 @@ var Point,
     isArray = H.isArray,
     isNumber = H.isNumber,
     pick = H.pick,
+    uniqueKey = H.uniqueKey,
+    defined = H.defined,
     removeEvent = H.removeEvent;
 
 /**
@@ -120,6 +121,9 @@ Highcharts.Point.prototype = {
 
         point.applyOptions(options, x);
 
+        // Add a unique ID to the point if none is assigned
+        point.id = defined(point.id) ? point.id : uniqueKey();
+
         if (series.options.colorByPoint) {
 
             
@@ -197,6 +201,9 @@ Highcharts.Point.prototype = {
         if (options.group) {
             delete point.group;
         }
+        if (options.dataLabels) {
+            delete point.dataLabels;
+        }
 
         /**
          * The y value of the point.
@@ -436,8 +443,8 @@ Highcharts.Point.prototype = {
             point.onMouseOut();
         }
 
-        // Remove all events
-        if (point.graphic || point.dataLabel) {
+        // Remove all events and elements
+        if (point.graphic || point.dataLabel || point.dataLabels) {
             removeEvent(point);
             point.destroyElements();
         }
@@ -474,6 +481,23 @@ Highcharts.Point.prototype = {
                 point[prop] = point[prop].destroy();
             }
         }
+        // Handle point.dataLabels and point.connectors
+        if (point.dataLabels) {
+            each(point.dataLabels, function (label) {
+                if (label.element) {
+                    label.destroy();
+                }
+            });
+            delete point.dataLabels;
+        }
+        if (point.connectors) {
+            each(point.connectors, function (connector) {
+                if (connector.element) {
+                    connector.destroy();
+                }
+            });
+            delete point.connectors;
+        }
     },
 
     /**

package/es-modules/parts/Pointer.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -647,11 +647,13 @@ Highcharts.Pointer.prototype = {
                 if (tooltip.shared && hoverPoints) { // #8284
                     each(hoverPoints, function (point) {
                         point.setState(point.state, true);
-                        if (point.series.xAxis.crosshair) {
-                            point.series.xAxis.drawCrosshair(null, point);
-                        }
-                        if (point.series.yAxis.crosshair) {
-                            point.series.yAxis.drawCrosshair(null, point);
+                        if (point.series.isCartesian) {
+                            if (point.series.xAxis.crosshair) {
+                                point.series.xAxis.drawCrosshair(null, point);
+                            }
+                            if (point.series.yAxis.crosshair) {
+                                point.series.yAxis.drawCrosshair(null, point);
+                            }
                         }
                     });
                 } else if (hoverPoint) { // #2500

package/es-modules/parts/RangeSelector.js

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

package/es-modules/parts/Responsive.js

@@ -1,12 +1,25 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
+
+/**
+ * A callback function to gain complete control on when the responsive rule
+ * applies.
+ *
+ * @callback Highcharts.ResponsiveCallbackFunction
+ *
+ * @return {boolean}
+ *         Return `true` if it applies.
+ */
+
 'use strict';
+
 import H from './Globals.js';
 import './Chart.js';
 import './Utilities.js';
+
 var Chart = H.Chart,
     each = H.each,
     inArray = H.inArray,
@@ -15,16 +28,20 @@ var Chart = H.Chart,
     pick = H.pick,
     splat = H.splat;
 
-
 /**
  * Allows setting a set of rules to apply for different screen or chart
  * sizes. Each rule specifies additional chart options.
  *
- * @sample {highstock} stock/demo/responsive/ Stock chart
- * @sample highcharts/responsive/axis/ Axis
- * @sample highcharts/responsive/legend/ Legend
- * @sample highcharts/responsive/classname/ Class name
- * @since 5.0.0
+ * @sample {highstock} stock/demo/responsive/
+ *         Stock chart
+ * @sample highcharts/responsive/axis/
+ *         Axis
+ * @sample highcharts/responsive/legend/
+ *         Legend
+ * @sample highcharts/responsive/classname/
+ *         Class name
+ *
+ * @since     5.0.0
  * @apioption responsive
  */
 
@@ -32,11 +49,15 @@ var Chart = H.Chart,
  * A set of rules for responsive settings. The rules are executed from
  * the top down.
  *
- * @type {Array<Object>}
- * @sample {highcharts} highcharts/responsive/axis/ Axis changes
- * @sample {highstock} highcharts/responsive/axis/ Axis changes
- * @sample {highmaps} highcharts/responsive/axis/ Axis changes
- * @since 5.0.0
+ * @sample {highcharts} highcharts/responsive/axis/
+ *         Axis changes
+ * @sample {highstock} highcharts/responsive/axis/
+ *         Axis changes
+ * @sample {highmaps} highcharts/responsive/axis/
+ *         Axis changes
+ *
+ * @type      {Array<*>}
+ * @since     5.0.0
  * @apioption responsive.rules
  */
 
@@ -53,20 +74,24 @@ var Chart = H.Chart,
  * with two series items without an `id`, will cause the existing chart's
  * two series to be updated with respective options.
  *
- * @type {Object}
- * @sample {highstock} stock/demo/responsive/ Stock chart
- * @sample highcharts/responsive/axis/ Axis
- * @sample highcharts/responsive/legend/ Legend
- * @sample highcharts/responsive/classname/ Class name
- * @since 5.0.0
+ * @sample {highstock} stock/demo/responsive/
+ *         Stock chart
+ * @sample highcharts/responsive/axis/
+ *         Axis
+ * @sample highcharts/responsive/legend/
+ *         Legend
+ * @sample highcharts/responsive/classname/
+ *         Class name
+ *
+ * @type      {Highcharts.Options}
+ * @since     5.0.0
  * @apioption responsive.rules.chartOptions
  */
 
 /**
  * Under which conditions the rule applies.
  *
- * @type {Object}
- * @since 5.0.0
+ * @since     5.0.0
  * @apioption responsive.rules.condition
  */
 
@@ -76,50 +101,57 @@ var Chart = H.Chart,
  * against other metrics than the chart size, or example the document
  * size or other elements.
  *
- * @type {Function}
- * @context Chart
- * @since 5.0.0
+ * @type      {Highcharts.ResponsiveCallbackFunction}
+ * @since     5.0.0
+ * @context   Highcharts.Chart
  * @apioption responsive.rules.condition.callback
  */
 
 /**
  * The responsive rule applies if the chart height is less than this.
  *
- * @type {Number}
- * @since 5.0.0
+ * @type      {number}
+ * @since     5.0.0
  * @apioption responsive.rules.condition.maxHeight
  */
 
 /**
  * The responsive rule applies if the chart width is less than this.
  *
- * @type {Number}
- * @sample highcharts/responsive/axis/ Max width is 500
- * @since 5.0.0
+ * @sample highcharts/responsive/axis/
+ *         Max width is 500
+ *
+ * @type      {number}
+ * @since     5.0.0
  * @apioption responsive.rules.condition.maxWidth
  */
 
 /**
  * The responsive rule applies if the chart height is greater than this.
  *
- * @type {Number}
- * @default 0
- * @since 5.0.0
+ * @type      {number}
+ * @default   0
+ * @since     5.0.0
  * @apioption responsive.rules.condition.minHeight
  */
 
 /**
  * The responsive rule applies if the chart width is greater than this.
  *
- * @type {Number}
- * @default 0
- * @since 5.0.0
+ * @type      {number}
+ * @default   0
+ * @since     5.0.0
  * @apioption responsive.rules.condition.minWidth
  */
 
 /**
  * Update the chart based on the current chart/document size and options for
  * responsiveness.
+ *
+ * @private
+ * @function Highcharts.Chart#setResponsive
+ *
+ * @param {boolean} [redraw=true]
  */
 Chart.prototype.setResponsive = function (redraw) {
     var options = this.options.responsive,
@@ -175,9 +207,17 @@ Chart.prototype.setResponsive = function (redraw) {
 };
 
 /**
- * Handle a single responsiveness rule
+ * Handle a single responsiveness rule.
+ *
+ * @private
+ * @function Highcharts.Chart#matchResponsiveRule
+ *
+ * @param {Highcharts.ResponsiveRulesConditionOptions} rule
+ *
+ * @param {Array<number>} matches
  */
 Chart.prototype.matchResponsiveRule = function (rule, matches) {
+
     var condition = rule.condition,
         fn = condition.callback || function () {
             return (
@@ -192,13 +232,19 @@ Chart.prototype.matchResponsiveRule = function (rule, matches) {
     if (fn.call(this)) {
         matches.push(rule._id);
     }
-
 };
 
 /**
  * Get the current values for a given set of options. Used before we update
  * the chart with a new responsiveness rule.
  * TODO: Restore axis options (by id?)
+ *
+ * @private
+ * @function Highcharts.Chart#currentOptions
+ *
+ * @param {Highcharts.Options} options
+ *
+ * @return {Highcharts.Options}
  */
 Chart.prototype.currentOptions = function (options) {