highcharts 9.1.1 → 9.2.2

package/modules/accessibility.src.js

@@ -1,5 +1,5 @@
 /**
- * @license Highcharts JS v9.1.1 (2021-06-04)
+ * @license Highcharts JS v9.2.2 (2021-08-24)
  *
  * Accessibility module
  *
@@ -254,7 +254,7 @@
 
         return HTMLUtilities;
     });
-    _registerModule(_modules, 'Accessibility/Utils/ChartUtilities.js', [_modules['Accessibility/Utils/HTMLUtilities.js'], _modules['Core/Utilities.js']], function (HTMLUtilities, U) {
+    _registerModule(_modules, 'Accessibility/Utils/ChartUtilities.js', [_modules['Accessibility/Utils/HTMLUtilities.js'], _modules['Core/Globals.js'], _modules['Core/Utilities.js']], function (HTMLUtilities, H, U) {
         /* *
          *
          *  (c) 2009-2021 Øystein Moseng
@@ -267,6 +267,7 @@
          *
          * */
         var stripHTMLTags = HTMLUtilities.stripHTMLTagsFromString;
+        var doc = H.doc;
         var defined = U.defined,
             find = U.find,
             fireEvent = U.fireEvent;
@@ -423,7 +424,10 @@
          */
         function unhideChartElementFromAT(chart, element) {
             element.setAttribute('aria-hidden', false);
-            if (element === chart.renderTo || !element.parentNode) {
+            if (element === chart.renderTo ||
+                !element.parentNode ||
+                element.parentNode === doc.body // #16126: Full screen printing
+            ) {
                 return;
             }
             // Hide siblings unless their hidden state is already explicitly set
@@ -1524,7 +1528,7 @@
 
         return KeyboardNavigation;
     });
-    _registerModule(_modules, 'Accessibility/Components/LegendComponent.js', [_modules['Core/Chart/Chart.js'], _modules['Core/Globals.js'], _modules['Core/Legend.js'], _modules['Core/Utilities.js'], _modules['Accessibility/AccessibilityComponent.js'], _modules['Accessibility/KeyboardNavigationHandler.js'], _modules['Accessibility/Utils/HTMLUtilities.js']], function (Chart, H, Legend, U, AccessibilityComponent, KeyboardNavigationHandler, HTMLUtilities) {
+    _registerModule(_modules, 'Accessibility/Components/LegendComponent.js', [_modules['Core/Animation/AnimationUtilities.js'], _modules['Core/Chart/Chart.js'], _modules['Core/Globals.js'], _modules['Core/Legend/Legend.js'], _modules['Core/Utilities.js'], _modules['Accessibility/AccessibilityComponent.js'], _modules['Accessibility/KeyboardNavigationHandler.js'], _modules['Accessibility/Utils/HTMLUtilities.js'], _modules['Accessibility/Utils/ChartUtilities.js']], function (A, Chart, H, Legend, U, AccessibilityComponent, KeyboardNavigationHandler, HTMLUtilities, ChartUtils) {
         /* *
          *
          *  (c) 2009-2021 Øystein Moseng
@@ -1536,13 +1540,17 @@
          *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
          *
          * */
+        var animObject = A.animObject;
         var addEvent = U.addEvent,
             extend = U.extend,
             find = U.find,
             fireEvent = U.fireEvent,
-            isNumber = U.isNumber;
+            isNumber = U.isNumber,
+            pick = U.pick,
+            syncTimeout = U.syncTimeout;
         var removeElement = HTMLUtilities.removeElement,
             stripHTMLTags = HTMLUtilities.stripHTMLTagsFromString;
+        var getChartTitle = ChartUtils.getChartTitle;
         /* eslint-disable no-invalid-this, valid-jsdoc */
         /**
          * @private
@@ -1630,6 +1638,13 @@
                         component.updateProxyPositionForItem(e.item);
                     }
                 });
+                this.addEvent(Legend, 'afterRender', function () {
+                    if (this.chart === component.chart &&
+                        this.chart.renderer &&
+                        component.recreateProxies()) {
+                        syncTimeout(function () { return component.updateProxiesPositions(); }, animObject(pick(this.chart.renderer.globalAnimation, true)).duration);
+                    }
+                });
             },
             /**
              * @private
@@ -1655,10 +1670,7 @@
              * of the proxy overlays.
              */
             onChartRender: function () {
-                if (shouldDoLegendA11y(this.chart)) {
-                    this.updateProxiesPositions();
-                }
-                else {
+                if (!shouldDoLegendA11y(this.chart)) {
                     this.removeProxies();
                 }
             },
@@ -1699,7 +1711,9 @@
                     this.addLegendListContainer();
                     this.proxyLegendItems();
                     this.updateLegendItemProxyVisibility();
+                    return true;
                 }
+                return false;
             },
             /**
              * @private
@@ -1719,7 +1733,8 @@
                         '').replace(/<br ?\/?>/g, ' '));
                 var legendLabel = chart.langFormat('accessibility.legend.legendLabel' + (legendTitle ? '' : 'NoTitle'), {
                         chart: chart,
-                        legendTitle: legendTitle
+                        legendTitle: legendTitle,
+                        chartTitle: getChartTitle(chart)
                     });
                 if (this.legendProxyGroup) {
                     this.legendProxyGroup.setAttribute('aria-label', legendLabel);
@@ -1762,7 +1777,7 @@
             },
             /**
              * @private
-             * @param {Highcharts.BubbleLegend|Point|Highcharts.Series} item
+             * @param {Highcharts.BubbleLegendItem|Point|Highcharts.Series} item
              */
             proxyLegendItem: function (item) {
                 if (!item.legendItem || !item.legendGroup || !this.legendListContainer) {
@@ -1912,7 +1927,8 @@
          *
          * */
         var extend = U.extend;
-        var unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT;
+        var getChartTitle = ChartUtilities.getChartTitle,
+            unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT;
         var removeElement = HTMLUtilities.removeElement,
             getFakeMouseEvent = HTMLUtilities.getFakeMouseEvent;
         /* eslint-disable no-invalid-this, valid-jsdoc */
@@ -1951,7 +1967,9 @@
             if (exportList && chart.exportContextMenu) {
                 // Reset hover states etc.
                 exportList.forEach(function (el) {
-                    if (el.className === 'highcharts-menu-item' && el.onmouseout) {
+                    if (el &&
+                        el.className === 'highcharts-menu-item' &&
+                        el.onmouseout) {
                         el.onmouseout(getFakeMouseEvent('mouseout'));
                     }
                 });
@@ -2104,7 +2122,7 @@
                     this.exportProxyGroup = this.addProxyGroup(
                     // Wrap in a region div if verbosity is high
                     a11yOptions.landmarkVerbosity === 'all' ? {
-                        'aria-label': chart.langFormat('accessibility.exporting.exportRegionLabel', { chart: chart }),
+                        'aria-label': chart.langFormat('accessibility.exporting.exportRegionLabel', { chart: chart, chartTitle: getChartTitle(chart) }),
                         'role': 'region'
                     } : {});
                     var button = getExportMenuButtonElement(this.chart);
@@ -2124,18 +2142,22 @@
                     // Set tabindex on the menu items to allow focusing by script
                     // Set role to give screen readers a chance to pick up the contents
                     exportList.forEach(function (item) {
-                        if (item.tagName === 'LI' &&
-                            !(item.children && item.children.length)) {
-                            item.setAttribute('tabindex', -1);
-                        }
-                        else {
-                            item.setAttribute('aria-hidden', 'true');
+                        if (item) {
+                            if (item.tagName === 'LI' &&
+                                !(item.children && item.children.length)) {
+                                item.setAttribute('tabindex', -1);
+                            }
+                            else {
+                                item.setAttribute('aria-hidden', 'true');
+                            }
                         }
                     });
                     // Set accessibility properties on parent div
-                    var parentDiv = exportList[0].parentNode;
-                    parentDiv.removeAttribute('aria-hidden');
-                    parentDiv.setAttribute('aria-label', chart.langFormat('accessibility.exporting.chartMenuLabel', { chart: chart }));
+                    var parentDiv = (exportList[0] && exportList[0].parentNode);
+                    if (parentDiv) {
+                        parentDiv.removeAttribute('aria-hidden');
+                        parentDiv.setAttribute('aria-label', chart.langFormat('accessibility.exporting.chartMenuLabel', { chart: chart }));
+                    }
                 }
             },
             /**
@@ -2173,7 +2195,7 @@
                     // Only run exporting navigation if exporting support exists and is
                     // enabled on chart
                     validate: function () {
-                        return chart.exportChart &&
+                        return !!chart.exporting &&
                             chart.options.exporting.enabled !== false &&
                             chart.options.exporting.accessibility.enabled !==
                                 false;
@@ -3056,7 +3078,7 @@
 
         return AnnotationsA11y;
     });
-    _registerModule(_modules, 'Accessibility/Components/SeriesComponent/SeriesDescriber.js', [_modules['Accessibility/Components/AnnotationsA11y.js'], _modules['Accessibility/Utils/ChartUtilities.js'], _modules['Core/FormatUtilities.js'], _modules['Accessibility/Utils/HTMLUtilities.js'], _modules['Core/Tooltip.js'], _modules['Core/Utilities.js']], function (AnnotationsA11y, ChartUtilities, F, HTMLUtilities, Tooltip, U) {
+    _registerModule(_modules, 'Accessibility/Components/SeriesComponent/SeriesDescriber.js', [_modules['Accessibility/Components/AnnotationsA11y.js'], _modules['Accessibility/Utils/ChartUtilities.js'], _modules['Core/FormatUtilities.js'], _modules['Accessibility/Utils/HTMLUtilities.js'], _modules['Core/Utilities.js']], function (AnnotationsA11y, ChartUtilities, F, HTMLUtilities, U) {
         /* *
          *
          *  (c) 2009-2021 Øystein Moseng
@@ -3263,20 +3285,15 @@
             var series = point.series,
                 chart = series.chart,
                 a11yOptions = chart.options.accessibility.point || {},
-                hasDateXAxis = series.xAxis && series.xAxis.dateTime;
-            if (hasDateXAxis) {
-                var tooltipDateFormat = Tooltip.prototype.getXDateFormat.call({
-                        getDateFormat: Tooltip.prototype.getDateFormat,
-                        chart: chart
-                    },
-                    point,
-                    chart.options.tooltip,
-                    series.xAxis),
+                dateXAxis = series.xAxis && series.xAxis.dateTime;
+            if (dateXAxis) {
+                var tooltipDateFormat = dateXAxis.getXDateFormat(point.x || 0,
+                    chart.options.tooltip.dateTimeLabelFormats),
                     dateFormat = a11yOptions.dateFormatter &&
                         a11yOptions.dateFormatter(point) ||
                         a11yOptions.dateFormat ||
                         tooltipDateFormat;
-                return chart.time.dateFormat(dateFormat, point.x, void 0);
+                return chart.time.dateFormat(dateFormat, point.x || 0, void 0);
             }
         }
         /**
@@ -3527,12 +3544,27 @@
         var doc = H.doc;
         var setElAttrs = HTMLUtilities.setElAttrs,
             visuallyHideElement = HTMLUtilities.visuallyHideElement;
+        /* *
+         *
+         *  Class
+         *
+         * */
         var Announcer = /** @class */ (function () {
+                /* *
+                 *
+                 *  Constructor
+                 *
+                 * */
                 function Announcer(chart, type) {
                     this.chart = chart;
                 this.domElementProvider = new DOMElementProvider();
                 this.announceRegion = this.addAnnounceRegion(type);
             }
+            /* *
+             *
+             *  Functions
+             *
+             * */
             Announcer.prototype.destroy = function () {
                 this.domElementProvider.destroyCreatedElements();
             };
@@ -3550,8 +3582,8 @@
                 }, 1000);
             };
             Announcer.prototype.addAnnounceRegion = function (type) {
-                var chartContainer = this.chart.announcerContainer || this.createAnnouncerContainer();
-                var div = this.domElementProvider.createElement('div');
+                var chartContainer = this.chart.announcerContainer || this.createAnnouncerContainer(),
+                    div = this.domElementProvider.createElement('div');
                 setElAttrs(div, {
                     'aria-hidden': false,
                     'aria-live': type
@@ -3561,8 +3593,8 @@
                 return div;
             };
             Announcer.prototype.createAnnouncerContainer = function () {
-                var chart = this.chart;
-                var container = doc.createElement('div');
+                var chart = this.chart,
+                    container = doc.createElement('div');
                 setElAttrs(container, {
                     'aria-hidden': false,
                     style: 'position:relative',
@@ -3574,7 +3606,11 @@
             };
             return Announcer;
         }());
-        H.Announcer = Announcer;
+        /* *
+         *
+         *  Default Export
+         *
+         * */
 
         return Announcer;
     });
@@ -5588,7 +5624,7 @@
                     }
                 }
                 // Create the text label
-                var text = lang[isMin ? 'rangeSelectorFrom' : 'rangeSelectorTo'];
+                var text = lang[isMin ? 'rangeSelectorFrom' : 'rangeSelectorTo'] || '';
                 var label = renderer
                         .label(text, 0)
                         .addClass('highcharts-range-label')
@@ -7278,7 +7314,6 @@
             getChartTitle = ChartUtilities.getChartTitle,
             unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT;
         var addClass = HTMLUtilities.addClass,
-            escapeStringForHTML = HTMLUtilities.escapeStringForHTML,
             getElement = HTMLUtilities.getElement,
             getHeadingTagNameForElement = HTMLUtilities.getHeadingTagNameForElement,
             setElAttrs = HTMLUtilities.setElAttrs,
@@ -7420,6 +7455,12 @@
                         },
                         insertIntoDOM: function (el, chart) {
                             chart.renderTo.insertBefore(el, chart.container.nextSibling);
+                        },
+                        afterInserted: function () {
+                            if (component.chart.accessibility) {
+                                component.chart.accessibility
+                                    .keyboardNavigation.updateExitAnchor(); // #15986
+                            }
                         }
                     }
                 };
@@ -7487,7 +7528,7 @@
              * @param {string} regionKey Name/key of the region we are setting attrs for
              */
             setScreenReaderSectionAttribs: function (sectionDiv, regionKey) {
-                var labelLangKey = ('accessibility.screenReaderSection.' + regionKey + 'RegionLabel'), chart = this.chart, labelText = chart.langFormat(labelLangKey, { chart: chart }), sectionId = 'highcharts-screen-reader-region-' + regionKey + '-' +
+                var labelLangKey = ('accessibility.screenReaderSection.' + regionKey + 'RegionLabel'), chart = this.chart, labelText = chart.langFormat(labelLangKey, { chart: chart, chartTitle: getChartTitle(chart) }), sectionId = 'highcharts-screen-reader-region-' + regionKey + '-' +
                         chart.index;
                 setElAttrs(sectionDiv, {
                     id: sectionId,
@@ -9089,7 +9130,7 @@
                      * @since 8.0.0
                      */
                     screenReaderSection: {
-                        beforeRegionLabel: 'Chart screen reader information.',
+                        beforeRegionLabel: 'Chart screen reader information, {chartTitle}.',
                         afterRegionLabel: '',
                         /**
                          * Language options for annotation descriptions.
@@ -9125,7 +9166,7 @@
                      * @since 8.0.0
                      */
                     legend: {
-                        legendLabelNoTitle: 'Toggle series visibility',
+                        legendLabelNoTitle: 'Toggle series visibility, {chartTitle}',
                         legendLabel: 'Chart legend: {legendTitle}',
                         legendItem: 'Show {itemName}'
                     },
@@ -9270,7 +9311,7 @@
                     exporting: {
                         chartMenuLabel: 'Chart menu',
                         menuButtonLabel: 'View chart menu',
-                        exportRegionLabel: 'Chart menu'
+                        exportRegionLabel: 'Chart menu, {chartTitle}'
                     },
                     /**
                      * Lang configuration for different series types. For more dynamic
@@ -9860,7 +9901,7 @@
         };
 
     });
-    _registerModule(_modules, 'Accessibility/FocusBorder.js', [_modules['Core/Chart/Chart.js'], _modules['Core/Globals.js'], _modules['Core/Renderer/SVG/SVGElement.js'], _modules['Core/Renderer/SVG/SVGLabel.js'], _modules['Core/Utilities.js']], function (Chart, H, SVGElement, SVGLabel, U) {
+    _registerModule(_modules, 'Accessibility/FocusBorder.js', [_modules['Core/Chart/Chart.js'], _modules['Core/Renderer/SVG/SVGElement.js'], _modules['Core/Renderer/SVG/SVGLabel.js'], _modules['Core/Utilities.js']], function (Chart, SVGElement, SVGLabel, U) {
         /* *
          *
          *  (c) 2009-2021 Øystein Moseng
@@ -10001,8 +10042,7 @@
                     var posXCorrection = 0,
                         posYCorrection = 0;
                     if (text.attr('text-anchor') === 'middle') {
-                        posXCorrection = H.isFirefox && text.rotation ? 0.25 : 0.5;
-                        posYCorrection = H.isFirefox && !text.rotation ? 0.75 : 0.5;
+                        posXCorrection = posYCorrection = 0.5;
                     }
                     else if (!text.rotation) {
                         posYCorrection = 0.75;