highcharts 9.3.3 → 10.2.0

package/es-modules/Accessibility/Components/MenuComponent.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
@@ -101,7 +103,6 @@ var MenuComponent = /** @class */ (function (_super) {
         if (menu) {
             menu.setAttribute('aria-hidden', 'true');
         }
-        this.isExportMenuShown = false;
         this.setExportButtonExpandedState('false');
     };
     /**
@@ -113,7 +114,6 @@ var MenuComponent = /** @class */ (function (_super) {
             this.addAccessibleContextMenuAttribs();
             unhideChartElementFromAT(chart, menu);
         }
-        this.isExportMenuShown = true;
         this.setExportButtonExpandedState('true');
     };
     /**
@@ -157,7 +157,8 @@ var MenuComponent = /** @class */ (function (_super) {
                     chart: chart,
                     chartTitle: getChartTitle(chart)
                 }),
-                'aria-expanded': false
+                'aria-expanded': false,
+                title: chart.options.lang.contextButtonTitle || null
             });
         }
     };
@@ -308,7 +309,7 @@ var MenuComponent = /** @class */ (function (_super) {
         var chart = this.chart;
         var curHighlightedItem = chart.exportDivElements[chart.highlightedExportItemIx];
         var exportButtonElement = getExportMenuButtonElement(chart).element;
-        if (this.isExportMenuShown) {
+        if (chart.openMenu) {
             this.fakeClickEvent(curHighlightedItem);
         }
         else {
@@ -377,7 +378,7 @@ var MenuComponent = /** @class */ (function (_super) {
      */
     function chartHideExportMenu() {
         var chart = this, exportList = chart.exportDivElements;
-        if (exportList && chart.exportContextMenu) {
+        if (exportList && chart.exportContextMenu && chart.openMenu) {
             // Reset hover states etc.
             exportList.forEach(function (el) {
                 if (el &&

package/es-modules/Accessibility/Components/RangeSelectorComponent.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
@@ -227,7 +229,7 @@ var RangeSelectorComponent = /** @class */ (function (_super) {
             if (chart.accessibility) {
                 chart.accessibility.keyboardNavigation.tabindexContainer
                     .focus();
-                chart.accessibility.keyboardNavigation[direction < 0 ? 'prev' : 'next']();
+                chart.accessibility.keyboardNavigation.move(direction);
             }
         }
         else if (rangeSel) {
@@ -315,7 +317,7 @@ var RangeSelectorComponent = /** @class */ (function (_super) {
                     e.stopPropagation();
                     if (a11y) {
                         a11y.keyboardNavigation.tabindexContainer.focus();
-                        a11y.keyboardNavigation[e.shiftKey ? 'prev' : 'next']();
+                        a11y.keyboardNavigation.move(e.shiftKey ? -1 : 1);
                     }
                 }
             });

package/es-modules/Accessibility/Components/SeriesComponent/ForcedMarkers.js

@@ -164,6 +164,7 @@ var ForcedMarkersComposition;
         else if (series.a11yMarkersForced) {
             delete series.a11yMarkersForced;
             unforceSeriesMarkerOptions(series);
+            delete series.resetA11yMarkerOptions;
         }
     }
     /**
@@ -189,20 +190,20 @@ var ForcedMarkersComposition;
         });
     }
     /**
+     * Reset markers to normal
      * @private
      */
     function unforceSeriesMarkerOptions(series) {
         var resetMarkerOptions = series.resetA11yMarkerOptions;
         if (resetMarkerOptions) {
-            merge(true, series.options, {
+            var originalOpactiy = resetMarkerOptions.states &&
+                resetMarkerOptions.states.normal &&
+                resetMarkerOptions.states.normal.opacity;
+            series.update({
                 marker: {
                     enabled: resetMarkerOptions.enabled,
                     states: {
-                        normal: {
-                            opacity: resetMarkerOptions.states &&
-                                resetMarkerOptions.states.normal &&
-                                resetMarkerOptions.states.normal.opacity
-                        }
+                        normal: { opacity: originalOpactiy }
                     }
                 }
             });

package/es-modules/Accessibility/Components/SeriesComponent/NewDataAnnouncer.js

@@ -117,7 +117,7 @@ var NewDataAnnouncer = /** @class */ (function () {
      */
     NewDataAnnouncer.prototype.addEventListeners = function () {
         var announcer = this, chart = this.chart, e = this.eventProvider;
-        e.addEvent(chart, 'afterDrilldown', function () {
+        e.addEvent(chart, 'afterApplyDrilldown', function () {
             announcer.lastAnnouncementTime = 0;
         });
         e.addEvent(chart, 'afterAddSeries', function (e) {

package/es-modules/Accessibility/Components/SeriesComponent/SeriesComponent.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
@@ -59,7 +61,6 @@ var SeriesComponent = /** @class */ (function (_super) {
      * @private
      */
     SeriesComponent.compose = function (ChartClass, PointClass, SeriesClass) {
-        // Handle forcing markers
         NewDataAnnouncer.compose(SeriesClass);
         ForcedMarkers.compose(SeriesClass);
         SeriesKeyboardNavigation.compose(ChartClass, PointClass, SeriesClass);

package/es-modules/Accessibility/Components/SeriesComponent/SeriesDescriber.js

@@ -43,13 +43,17 @@ function findFirstPointWithGraphic(point) {
     }) || null;
 }
 /**
+ * Whether or not we should add a dummy point element in
+ * order to describe a point that has no graphic.
  * @private
  */
 function shouldAddDummyPoint(point) {
     // Note: Sunburst series use isNull for hidden points on drilldown.
     // Ignore these.
-    var isSunburst = point.series && point.series.is('sunburst'), isNull = point.isNull;
-    return isNull && !isSunburst;
+    var series = point.series, chart = series && series.chart, isSunburst = series && series.is('sunburst'), isNull = point.isNull, shouldDescribeNull = chart &&
+        chart
+            .options.accessibility.point.describeNull;
+    return isNull && !isSunburst && shouldDescribeNull;
 }
 /**
  * @private
@@ -258,9 +262,9 @@ function getPointValueDescription(point) {
  * @private
  */
 function defaultPointDescriptionFormatter(point) {
-    var series = point.series, chart = series.chart, valText = getPointValueDescription(point), description = point.options && point.options.accessibility &&
-        point.options.accessibility.description, userDescText = description ? ' ' + description : '', seriesNameText = chart.series.length > 1 && series.name ?
-        ' ' + series.name + '.' : '', annotationsDesc = getPointAnnotationDescription(point), pointAnnotationsText = annotationsDesc ? ' ' + annotationsDesc : '';
+    var series = point.series, shouldExposeSeriesName = series.chart.series.length > 1 ||
+        series.options.name, valText = getPointValueDescription(point), description = point.options && point.options.accessibility &&
+        point.options.accessibility.description, userDescText = description ? ' ' + description : '', seriesNameText = shouldExposeSeriesName ? ' ' + series.name + '.' : '', annotationsDesc = getPointAnnotationDescription(point), pointAnnotationsText = annotationsDesc ? ' ' + annotationsDesc : '';
     point.accessibility = point.accessibility || {};
     point.accessibility.valueDescription = valText;
     return valText + userDescText + seriesNameText + pointAnnotationsText;
@@ -287,15 +291,19 @@ function setPointScreenReaderAttribs(point, pointElement) {
  * @param {Highcharts.Series} series
  */
 function describePointsInSeries(series) {
-    var setScreenReaderProps = shouldSetScreenReaderPropsOnPoints(series), setKeyboardProps = shouldSetKeyboardNavPropsOnPoints(series);
+    var setScreenReaderProps = shouldSetScreenReaderPropsOnPoints(series), setKeyboardProps = shouldSetKeyboardNavPropsOnPoints(series), shouldDescribeNullPoints = series.chart.options.accessibility
+        .point.describeNull;
     if (setScreenReaderProps || setKeyboardProps) {
         series.points.forEach(function (point) {
             var pointEl = point.graphic && point.graphic.element ||
-                shouldAddDummyPoint(point) && addDummyPointElement(point);
-            var pointA11yDisabled = (point.options &&
+                shouldAddDummyPoint(point) && addDummyPointElement(point), pointA11yDisabled = (point.options &&
                 point.options.accessibility &&
                 point.options.accessibility.enabled === false);
             if (pointEl) {
+                if (point.isNull && !shouldDescribeNullPoints) {
+                    pointEl.setAttribute('aria-hidden', true);
+                    return;
+                }
                 // We always set tabindex, as long as we are setting props.
                 // When setting tabindex, also remove default outline to
                 // avoid ugly border on click.
@@ -320,14 +328,19 @@ function describePointsInSeries(series) {
 function defaultSeriesDescriptionFormatter(series) {
     var chart = series.chart, chartTypes = chart.types || [], description = getSeriesDescriptionText(series), shouldDescribeAxis = function (coll) {
         return chart[coll] && chart[coll].length > 1 && series[coll];
-    }, xAxisInfo = getSeriesAxisDescriptionText(series, 'xAxis'), yAxisInfo = getSeriesAxisDescriptionText(series, 'yAxis'), summaryContext = {
-        name: series.name || '',
-        ix: series.index + 1,
-        numSeries: chart.series && chart.series.length,
-        numPoints: series.points && series.points.length,
-        series: series
-    }, combinationSuffix = chartTypes.length > 1 ? 'Combination' : '', summary = chart.langFormat('accessibility.series.summary.' + series.type + combinationSuffix, summaryContext) || chart.langFormat('accessibility.series.summary.default' + combinationSuffix, summaryContext);
-    return summary + (description ? ' ' + description : '') + (shouldDescribeAxis('yAxis') ? ' ' + yAxisInfo : '') + (shouldDescribeAxis('xAxis') ? ' ' + xAxisInfo : '');
+    }, seriesNumber = series.index + 1, xAxisInfo = getSeriesAxisDescriptionText(series, 'xAxis'), yAxisInfo = getSeriesAxisDescriptionText(series, 'yAxis'), summaryContext = {
+        seriesNumber: seriesNumber,
+        series: series,
+        chart: chart
+    }, combinationSuffix = chartTypes.length > 1 ? 'Combination' : '', summary = chart.langFormat('accessibility.series.summary.' + series.type + combinationSuffix, summaryContext) || chart.langFormat('accessibility.series.summary.default' + combinationSuffix, summaryContext), axisDescription = (shouldDescribeAxis('yAxis') ? ' ' + yAxisInfo + '.' : '') + (shouldDescribeAxis('xAxis') ? ' ' + xAxisInfo + '.' : ''), formatStr = chart.options.accessibility.series.descriptionFormat || '';
+    return format(formatStr, {
+        seriesDescription: summary,
+        authorDescription: (description ? ' ' + description : ''),
+        axisDescription: axisDescription,
+        series: series,
+        chart: chart,
+        seriesNumber: seriesNumber
+    }, void 0);
 }
 /**
  * Set a11y props on a series element
@@ -343,7 +356,10 @@ function describeSeriesElement(series, seriesElement) {
     }
     else if (landmarkVerbosity === 'all') {
         seriesElement.setAttribute('role', 'region');
-    } /* else do not add role */
+    }
+    else {
+        seriesElement.setAttribute('role', 'group');
+    }
     seriesElement.setAttribute('tabindex', '-1');
     if (!series.chart.styledMode) {
         // Don't show browser outline on click, despite tabindex
@@ -373,7 +389,7 @@ function describeSeries(series) {
             describeSeriesElement(series, seriesEl);
         }
         else {
-            seriesEl.setAttribute('aria-label', '');
+            seriesEl.removeAttribute('aria-label');
         }
     }
 }

package/es-modules/Accessibility/Components/SeriesComponent/SeriesKeyboardNavigation.js

@@ -84,6 +84,35 @@ function isSkipPoint(point) {
         pointA11yDisabled ||
         isSkipSeries(point.series);
 }
+/**
+ * Get the first point that is not a skip point in this series.
+ * @private
+ */
+function getFirstValidPointInSeries(series) {
+    var points = series.points || [], len = points.length;
+    for (var i = 0; i < len; ++i) {
+        if (!isSkipPoint(points[i])) {
+            return points[i];
+        }
+    }
+    return null;
+}
+/**
+ * Get the first point that is not a skip point in this chart.
+ * @private
+ */
+function getFirstValidPointInChart(chart) {
+    var series = chart.series || [], len = series.length;
+    for (var i = 0; i < len; ++i) {
+        if (!isSkipSeries(series[i])) {
+            var point = getFirstValidPointInSeries(series[i]);
+            if (point) {
+                return point;
+            }
+        }
+    }
+    return null;
+}
 /**
  * @private
  */
@@ -95,7 +124,7 @@ function highlightLastValidPointInChart(chart) {
         // Highlight first valid point in the series will also
         // look backwards. It always starts from currently
         // highlighted point.
-        res = chart.series[i].highlightFirstValidPoint();
+        res = chart.series[i].highlightNextValidPoint();
         if (res) {
             break;
         }
@@ -103,24 +132,24 @@ function highlightLastValidPointInChart(chart) {
     return res;
 }
 /**
+ * After drilling down/up, we need to set focus to the first point for
+ * screen readers and keyboard nav.
  * @private
  */
 function updateChartFocusAfterDrilling(chart) {
-    highlightFirstValidPointInChart(chart);
-    if (chart.focusElement) {
-        chart.focusElement.removeFocusBorder();
+    var point = getFirstValidPointInChart(chart);
+    if (point) {
+        point.highlight(false); // Do not visually highlight
     }
 }
 /**
+ * Highlight the first point in chart that is not a skip point
  * @private
  */
 function highlightFirstValidPointInChart(chart) {
-    var res = false;
     delete chart.highlightedPoint;
-    res = chart.series.reduce(function (acc, cur) {
-        return acc || cur.highlightFirstValidPoint();
-    }, false);
-    return res;
+    var point = getFirstValidPointInChart(chart);
+    return point ? point.highlight() : false;
 }
 /* *
  *
@@ -156,7 +185,7 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         e.addEvent(Series, 'destroy', function () {
             return keyboardNavigation.onSeriesDestroy(this);
         });
-        e.addEvent(chart, 'afterDrilldown', function () {
+        e.addEvent(chart, 'afterApplyDrilldown', function () {
             updateChartFocusAfterDrilling(this);
         });
         e.addEvent(chart, 'drilldown', function (e) {
@@ -195,25 +224,23 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         });
     };
     /**
+     * After drillup we want to find the point that was drilled down to and
+     * highlight it.
      * @private
      */
     SeriesKeyboardNavigation.prototype.onDrillupAll = function () {
-        // After drillup we want to find the point that was drilled down to and
-        // highlight it.
         var last = this.lastDrilledDownPoint, chart = this.chart, series = last && getSeriesFromName(chart, last.seriesName);
         var point;
         if (last && series && defined(last.x) && defined(last.y)) {
             point = getPointFromXY(series, last.x, last.y);
         }
+        point = point || getFirstValidPointInChart(chart);
         // Container focus can be lost on drillup due to deleted elements.
         if (chart.container) {
             chart.container.focus();
         }
         if (point && point.highlight) {
-            point.highlight();
-        }
-        if (chart.focusElement) {
-            chart.focusElement.removeFocusBorder();
+            point.highlight(false); // Do not visually highlight
         }
     };
     /**
@@ -223,13 +250,16 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         var keyboardNavigation = this, keys = this.keyCodes, chart = this.chart, inverted = chart.inverted;
         return new KeyboardNavigationHandler(chart, {
             keyCodeMap: [
-                [inverted ? [keys.up, keys.down] : [keys.left, keys.right], function (keyCode) {
+                [inverted ? [keys.up, keys.down] : [keys.left, keys.right],
+                    function (keyCode) {
                         return keyboardNavigation.onKbdSideways(this, keyCode);
                     }],
-                [inverted ? [keys.left, keys.right] : [keys.up, keys.down], function (keyCode) {
+                [inverted ? [keys.left, keys.right] : [keys.up, keys.down],
+                    function (keyCode) {
                         return keyboardNavigation.onKbdVertical(this, keyCode);
                     }],
-                [[keys.enter, keys.space], function (keyCode, event) {
+                [[keys.enter, keys.space],
+                    function (keyCode, event) {
                         var point = chart.highlightedPoint;
                         if (point) {
                             event.point = point;
@@ -238,22 +268,27 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
                         }
                         return this.response.success;
                     }],
-                [[keys.home], function () {
+                [[keys.home],
+                    function () {
                         highlightFirstValidPointInChart(chart);
                         return this.response.success;
                     }],
-                [[keys.end], function () {
+                [[keys.end],
+                    function () {
                         highlightLastValidPointInChart(chart);
                         return this.response.success;
                     }],
-                [[keys.pageDown, keys.pageUp], function (keyCode) {
+                [[keys.pageDown, keys.pageUp],
+                    function (keyCode) {
                         chart.highlightAdjacentSeries(keyCode === keys.pageDown);
                         return this.response.success;
                     }]
             ],
             init: function () {
-                highlightFirstValidPointInChart(chart);
-                return this.response.success;
+                return keyboardNavigation.onHandlerInit(this);
+            },
+            validate: function () {
+                return !!getFirstValidPointInChart(chart);
             },
             terminate: function () {
                 return keyboardNavigation.onHandlerTerminate();
@@ -271,6 +306,24 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         var keys = this.keyCodes, isNext = keyCode === keys.right || keyCode === keys.down;
         return this.attemptHighlightAdjacentPoint(handler, isNext);
     };
+    /**
+     * When keyboard navigation inits.
+     * @private
+     * @param {Highcharts.KeyboardNavigationHandler} handler The handler object
+     * @return {number}
+     * response
+     */
+    SeriesKeyboardNavigation.prototype.onHandlerInit = function (handler) {
+        var chart = this.chart, kbdNavOptions = chart.options.accessibility.keyboardNavigation;
+        if (kbdNavOptions.seriesNavigation.rememberPointFocus &&
+            chart.highlightedPoint) {
+            chart.highlightedPoint.highlight();
+        }
+        else {
+            highlightFirstValidPointInChart(chart);
+        }
+        return handler.response.success;
+    };
     /**
      * @private
      * @param {Highcharts.KeyboardNavigationHandler} handler
@@ -297,7 +350,7 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
      * @private
      */
     SeriesKeyboardNavigation.prototype.onHandlerTerminate = function () {
-        var chart = this.chart;
+        var chart = this.chart, kbdNavOptions = chart.options.accessibility.keyboardNavigation;
         if (chart.tooltip) {
             chart.tooltip.hide(0);
         }
@@ -308,22 +361,22 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         if (chart.highlightedPoint && chart.highlightedPoint.onMouseOut) {
             chart.highlightedPoint.onMouseOut();
         }
-        delete chart.highlightedPoint;
+        if (!kbdNavOptions.seriesNavigation.rememberPointFocus) {
+            delete chart.highlightedPoint;
+        }
     };
     /**
      * Function that attempts to highlight next/prev point. Handles wrap around.
      * @private
-     * @param {Highcharts.KeyboardNavigationHandler} handler
-     * @param {boolean} directionIsNext
-     * @return {number}
-     * response
      */
     SeriesKeyboardNavigation.prototype.attemptHighlightAdjacentPoint = function (handler, directionIsNext) {
         var chart = this.chart, wrapAround = chart.options.accessibility.keyboardNavigation
             .wrapAround, highlightSuccessful = chart.highlightAdjacentPoint(directionIsNext);
         if (!highlightSuccessful) {
-            if (wrapAround) {
-                return handler.init(directionIsNext ? 1 : -1);
+            if (wrapAround && (directionIsNext ?
+                highlightFirstValidPointInChart(chart) :
+                highlightLastValidPointInChart(chart))) {
+                return handler.response.success;
             }
             return handler.response[directionIsNext ? 'next' : 'prev'];
         }
@@ -515,7 +568,7 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         // Highlight the new point or any first valid point back or forwards
         // from it
         newPoint.highlight();
-        return newPoint.series.highlightFirstValidPoint();
+        return newPoint.series.highlightNextValidPoint();
     }
     /**
      * @private
@@ -552,7 +605,7 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
                     seriesTypes[type].prototype.keyboardMoveVertical = false;
                 }
             });
-            seriesProto.highlightFirstValidPoint = (seriesHighlightFirstValidPoint);
+            seriesProto.highlightNextValidPoint = (seriesHighlightNextValidPoint);
         }
     }
     SeriesKeyboardNavigation.compose = compose;
@@ -586,7 +639,7 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         return defined(minIx) ? series.points[minIx] : void 0;
     }
     /**
-     * Highlights a point (show tooltip and display hover state).
+     * Highlights a point (show tooltip, display hover state, focus element).
      *
      * @private
      * @function Highcharts.Point#highlight
@@ -594,9 +647,10 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
      * @return {Highcharts.Point}
      *         This highlighted point.
      */
-    function pointHighlight() {
+    function pointHighlight(highlightVisually) {
+        if (highlightVisually === void 0) { highlightVisually = true; }
         var chart = this.series.chart;
-        if (!this.isNull) {
+        if (!this.isNull && highlightVisually) {
             this.onMouseOver(); // Show the hover marker and tooltip
         }
         else {
@@ -611,6 +665,9 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
         // change z-index and mess up the element.
         if (this.graphic) {
             chart.setFocusToElement(this.graphic);
+            if (!highlightVisually && chart.focusElement) {
+                chart.focusElement.removeFocusBorder();
+            }
         }
         chart.highlightedPoint = this;
         return this;
@@ -621,9 +678,9 @@ var SeriesKeyboardNavigation = /** @class */ (function () {
      * point in the series, use that as starting point.
      *
      * @private
-     * @function Highcharts.Series#highlightFirstValidPoint
+     * @function Highcharts.Series#highlightNextValidPoint
      */
-    function seriesHighlightFirstValidPoint() {
+    function seriesHighlightNextValidPoint() {
         var curPoint = this.chart.highlightedPoint, start = (curPoint && curPoint.series) === this ?
             getPointIndex(curPoint) :
             0, points = this.points, len = points.length;