highcharts 9.3.2 → 10.1.0

package/es-modules/Extensions/Exporting/Exporting.js

@@ -18,7 +18,7 @@ var defaultOptions = D.defaultOptions;
 import ExportingDefaults from './ExportingDefaults.js';
 import ExportingSymbols from './ExportingSymbols.js';
 import G from '../../Core/Globals.js';
-var doc = G.doc, win = G.win;
+var doc = G.doc, SVG_NS = G.SVG_NS, win = G.win;
 import HU from '../../Core/HttpUtilities.js';
 import U from '../../Core/Utilities.js';
 var addEvent = U.addEvent, css = U.css, createElement = U.createElement, discardElement = U.discardElement, extend = U.extend, find = U.find, fireEvent = U.fireEvent, isObject = U.isObject, merge = U.merge, objectEach = U.objectEach, pick = U.pick, removeEvent = U.removeEvent, uniqueKey = U.uniqueKey;
@@ -103,13 +103,12 @@ var Exporting;
         if (btnOptions.enabled === false || !btnOptions.theme) {
             return;
         }
-        var attr = btnOptions.theme, states = attr.states, hover = states && states.hover, select = states && states.select;
+        var attr = btnOptions.theme;
         var callback;
         if (!chart.styledMode) {
             attr.fill = pick(attr.fill, "#ffffff" /* backgroundColor */);
             attr.stroke = pick(attr.stroke, 'none');
         }
-        delete attr.states;
         if (onclick) {
             callback = function (e) {
                 if (e) {
@@ -144,7 +143,7 @@ var Exporting;
             attr.stroke = pick(attr.stroke, 'none');
         }
         var button = renderer
-            .button(btnOptions.text, 0, 0, callback, attr, hover, select)
+            .button(btnOptions.text, 0, 0, callback, attr)
             .addClass(options.className)
             .attr({
             title: pick(chart.options.lang[btnOptions._titleKey || btnOptions.titleKey], '')
@@ -463,7 +462,7 @@ var Exporting;
                             };
                             css(element, extend({
                                 cursor: 'pointer'
-                            }, navOptions.menuItemStyle));
+                            }, navOptions.menuItemStyle || {}));
                         }
                     }
                     // Keep references to menu divs to be able to destroy them
@@ -825,10 +824,10 @@ var Exporting;
             visibility: 'hidden'
         });
         doc.body.appendChild(iframe);
-        var iframeDoc = iframe.contentWindow.document;
-        iframeDoc.open();
-        iframeDoc.write('<svg xmlns="http://www.w3.org/2000/svg"></svg>');
-        iframeDoc.close();
+        var iframeDoc = (iframe.contentWindow && iframe.contentWindow.document);
+        if (iframeDoc) {
+            iframeDoc.body.appendChild(iframeDoc.createElementNS(SVG_NS, 'svg'));
+        }
         /**
          * Call this on all elements and recurse to children
          * @private
@@ -836,7 +835,10 @@ var Exporting;
          *        Element child
              */
         function recurse(node) {
-            var styles, parentStyles, cssText = '', dummy, styleAttr, blacklisted, whitelisted, i;
+            var filteredStyles = {};
+            var styles, parentStyles, 
+            // cssText = '',
+            dummy, styleAttr, blacklisted, whitelisted, i;
             /**
              * Check computed styles and whether they are in the white/blacklist
              * for styles or atttributes.
@@ -883,12 +885,13 @@ var Exporting;
                             // Styles
                         }
                         else {
-                            cssText += hyphenate(prop) + ':' + val + ';';
+                            filteredStyles[prop] = val;
                         }
                     }
                 }
             }
-            if (node.nodeType === 1 &&
+            if (iframeDoc &&
+                node.nodeType === 1 &&
                 unstyledElements.indexOf(node.nodeName) === -1) {
                 styles = win.getComputedStyle(node, null);
                 parentStyles = node.nodeName === 'svg' ?
@@ -917,20 +920,28 @@ var Exporting;
                     dummySVG.removeChild(dummy);
                 }
                 // Loop through all styles and add them inline if they are ok
-                if (G.isFirefox || G.isMS) {
-                    // Some browsers put lots of styles on the prototype
-                    for (var p in styles) { // eslint-disable-line guard-for-in
+                for (var p in styles) {
+                    if (
+                    // Some browsers put lots of styles on the prototype...
+                    G.isFirefox ||
+                        G.isMS ||
+                        G.isSafari || // #16902
+                        // ... Chrome puts them on the instance
+                        Object.hasOwnProperty.call(styles, p)) {
                         filterStyles(styles[p], p);
                     }
                 }
-                else {
-                    objectEach(styles, filterStyles);
-                }
                 // Apply styles
+                /*
                 if (cssText) {
                     styleAttr = node.getAttribute('style');
-                    node.setAttribute('style', (styleAttr ? styleAttr + ';' : '') + cssText);
+                    node.setAttribute(
+                        'style',
+                        (styleAttr ? styleAttr + ';' : '') + cssText
+                    );
                 }
+                */
+                css(node, filteredStyles);
                 // Set default stroke width (needed at least for IE)
                 if (node.nodeName === 'svg') {
                     node.setAttribute('stroke-width', '1px');
@@ -945,7 +956,7 @@ var Exporting;
         /**
          * Remove the dummy objects used to get defaults
          * @private
-             */
+         */
         function tearDown() {
             dummySVG.parentNode.removeChild(dummySVG);
             // Remove trash from DOM that stayed after each exporting

package/es-modules/Extensions/Exporting/ExportingDefaults.js

@@ -132,7 +132,7 @@ var exporting = {
      * Path where Highcharts will look for export module dependencies to
      * load on demand if they don't already exist on `window`. Should currently
      * point to location of [CanVG](https://github.com/canvg/canvg) library,
-     * [jsPDF](https://github.com/yWorks/jsPDF) and
+     * [jsPDF](https://github.com/parallax/jsPDF) and
      * [svg2pdf.js](https://github.com/yWorks/svg2pdf.js), required for client
      * side export in certain browsers.
      *
@@ -196,6 +196,54 @@ var exporting = {
      * @since 2.0
      */
     url: 'https://export.highcharts.com/',
+    /**
+     * Settings for a custom font for the exported PDF, when using the
+     * `offline-exporting` module. This is used for languages containing
+     * non-ASCII characters, like Chinese, Russian, Japanese etc.
+     *
+     * As described in the [jsPDF
+     * docs](https://github.com/parallax/jsPDF#use-of-unicode-characters--utf-8),
+     * the 14 standard fonts in PDF are limited to the ASCII-codepage.
+     * Therefore, in order to support other text in the exported PDF, one or
+     * more TTF font files have to be passed on to the exporting module.
+     *
+     * See more in [the
+     * docs](https://www.highcharts.com/docs/export-module/client-side-export).
+     *
+     * @sample {highcharts} highcharts/exporting/offline-download-pdffont/
+     *         Download PDF in a language containing non-Latin characters.
+     *
+     * @since 10.0.0
+     * @requires modules/offline-exporting
+     */
+    pdfFont: {
+        /**
+         * The TTF font file for normal `font-style`. If font variations like
+         * `bold` or `italic` are not defined, the `normal` font will be used
+         * for those too.
+         *
+         * @type string|undefined
+         */
+        normal: void 0,
+        /**
+         * The TTF font file for bold text.
+         *
+         * @type string|undefined
+         */
+        bold: void 0,
+        /**
+         * The TTF font file for bold and italic text.
+         *
+         * @type string|undefined
+         */
+        bolditalic: void 0,
+        /**
+         * The TTF font file for italic text.
+         *
+         * @type string|undefined
+         */
+        italic: void 0
+    },
     /**
      * When printing the chart from the menu item in the burger menu, if
      * the on-screen chart exceeds this width, it is resized. After printing

package/es-modules/Extensions/FullScreen.js

@@ -11,7 +11,7 @@ import H from '../Core/Globals.js';
 var doc = H.doc;
 import AST from '../Core/Renderer/HTML/AST.js';
 import U from '../Core/Utilities.js';
-var addEvent = U.addEvent;
+var addEvent = U.addEvent, fireEvent = U.fireEvent;
 /**
  * The module allows user to enable display chart in full screen mode.
  * Used in StockTools too.
@@ -101,26 +101,30 @@ var Fullscreen = /** @class */ (function () {
      */
     Fullscreen.prototype.close = function () {
         var fullscreen = this, chart = fullscreen.chart, optionsChart = chart.options.chart;
-        // Don't fire exitFullscreen() when user exited using 'Escape' button.
-        if (fullscreen.isOpen &&
-            fullscreen.browserProps &&
-            chart.container.ownerDocument instanceof Document) {
-            chart.container.ownerDocument[fullscreen.browserProps.exitFullscreen]();
-        }
-        // Unbind event as it's necessary only before exiting from fullscreen.
-        if (fullscreen.unbindFullscreenEvent) {
-            fullscreen.unbindFullscreenEvent = fullscreen
-                .unbindFullscreenEvent();
-        }
-        chart.setSize(fullscreen.origWidth, fullscreen.origHeight, false);
-        fullscreen.origWidth = void 0;
-        fullscreen.origHeight = void 0;
-        optionsChart.width = fullscreen.origWidthOption;
-        optionsChart.height = fullscreen.origHeightOption;
-        fullscreen.origWidthOption = void 0;
-        fullscreen.origHeightOption = void 0;
-        fullscreen.isOpen = false;
-        fullscreen.setButtonText();
+        fireEvent(chart, 'fullscreenClose', null, function () {
+            // Don't fire exitFullscreen() when user exited
+            // using 'Escape' button.
+            if (fullscreen.isOpen &&
+                fullscreen.browserProps &&
+                chart.container.ownerDocument instanceof Document) {
+                chart.container.ownerDocument[fullscreen.browserProps.exitFullscreen]();
+            }
+            // Unbind event as it's necessary only before exiting
+            // from fullscreen.
+            if (fullscreen.unbindFullscreenEvent) {
+                fullscreen.unbindFullscreenEvent = fullscreen
+                    .unbindFullscreenEvent();
+            }
+            chart.setSize(fullscreen.origWidth, fullscreen.origHeight, false);
+            fullscreen.origWidth = void 0;
+            fullscreen.origHeight = void 0;
+            optionsChart.width = fullscreen.origWidthOption;
+            optionsChart.height = fullscreen.origHeightOption;
+            fullscreen.origWidthOption = void 0;
+            fullscreen.origHeightOption = void 0;
+            fullscreen.isOpen = false;
+            fullscreen.setButtonText();
+        });
     };
     /**
      * Displays the chart in fullscreen mode.
@@ -136,41 +140,44 @@ var Fullscreen = /** @class */ (function () {
      */
     Fullscreen.prototype.open = function () {
         var fullscreen = this, chart = fullscreen.chart, optionsChart = chart.options.chart;
-        if (optionsChart) {
-            fullscreen.origWidthOption = optionsChart.width;
-            fullscreen.origHeightOption = optionsChart.height;
-        }
-        fullscreen.origWidth = chart.chartWidth;
-        fullscreen.origHeight = chart.chartHeight;
-        // Handle exitFullscreen() method when user clicks 'Escape' button.
-        if (fullscreen.browserProps) {
-            var unbindChange_1 = addEvent(chart.container.ownerDocument, // chart's document
-            fullscreen.browserProps.fullscreenChange, function () {
-                // Handle lack of async of browser's fullScreenChange event.
-                if (fullscreen.isOpen) {
-                    fullscreen.isOpen = false;
-                    fullscreen.close();
-                }
-                else {
-                    chart.setSize(null, null, false);
-                    fullscreen.isOpen = true;
-                    fullscreen.setButtonText();
-                }
-            });
-            var unbindDestroy_1 = addEvent(chart, 'destroy', unbindChange_1);
-            fullscreen.unbindFullscreenEvent = function () {
-                unbindChange_1();
-                unbindDestroy_1();
-            };
-            var promise = chart.renderTo[fullscreen.browserProps.requestFullscreen]();
-            if (promise) {
-                // No dot notation because of IE8 compatibility
-                promise['catch'](function () {
-                    alert(// eslint-disable-line no-alert
-                    'Full screen is not supported inside a frame.');
+        fireEvent(chart, 'fullscreenOpen', null, function () {
+            if (optionsChart) {
+                fullscreen.origWidthOption = optionsChart.width;
+                fullscreen.origHeightOption = optionsChart.height;
+            }
+            fullscreen.origWidth = chart.chartWidth;
+            fullscreen.origHeight = chart.chartHeight;
+            // Handle exitFullscreen() method when user clicks 'Escape' button.
+            if (fullscreen.browserProps) {
+                var unbindChange_1 = addEvent(chart.container.ownerDocument, // chart's document
+                fullscreen.browserProps.fullscreenChange, function () {
+                    // Handle lack of async of browser's
+                    // fullScreenChange event.
+                    if (fullscreen.isOpen) {
+                        fullscreen.isOpen = false;
+                        fullscreen.close();
+                    }
+                    else {
+                        chart.setSize(null, null, false);
+                        fullscreen.isOpen = true;
+                        fullscreen.setButtonText();
+                    }
                 });
+                var unbindDestroy_1 = addEvent(chart, 'destroy', unbindChange_1);
+                fullscreen.unbindFullscreenEvent = function () {
+                    unbindChange_1();
+                    unbindDestroy_1();
+                };
+                var promise = chart.renderTo[fullscreen.browserProps.requestFullscreen]();
+                if (promise) {
+                    // No dot notation because of IE8 compatibility
+                    promise['catch'](function () {
+                        alert(// eslint-disable-line no-alert
+                        'Full screen is not supported inside a frame.');
+                    });
+                }
             }
-        }
+        });
     };
     /**
      * Replaces the exporting context button's text when toogling the
@@ -238,3 +245,63 @@ addEvent(Chart, 'beforeRender', function () {
      */
     this.fullscreen = new H.Fullscreen(this);
 });
+/* *
+ *
+ *  API Declarations
+ *
+ * */
+/**
+ * Gets fired when closing the fullscreen
+ *
+ * @callback Highcharts.FullScreenfullscreenCloseCallbackFunction
+ *
+ * @param {Highcharts.Chart} chart
+ *        The chart on which the event occured.
+ *
+ * @param {global.Event} event
+ *        The event that occured.
+ */
+/**
+ * Gets fired when opening the fullscreen
+ *
+ * @callback Highcharts.FullScreenfullscreenOpenCallbackFunction
+ *
+ * @param {Highcharts.Chart} chart
+ *        The chart on which the event occured.
+ *
+ * @param {global.Event} event
+ *        The event that occured.
+ */
+/* *
+ *
+ *  API Options
+ *
+ * */
+/**
+ * Fires when a fullscreen is closed through the context menu item,
+ * or a fullscreen is closed on the `Escape` button click,
+ * or the `Chart.fullscreen.close` method.
+ *
+ * @sample highcharts/chart/events-fullscreen
+ *         Title size change on fullscreen open
+ *
+ * @type      {Highcharts.FullScreenfullscreenCloseCallbackFunction}
+ * @since 10.1.0
+ * @context   Highcharts.Chart
+ * @requires  modules/full-screen
+ * @apioption chart.events.fullscreenClose
+ */
+/**
+ * Fires when a fullscreen is opened through the context menu item,
+ * or the `Chart.fullscreen.open` method.
+ *
+ * @sample highcharts/chart/events-fullscreen
+ *         Title size change on fullscreen open
+ *
+ * @type      {Highcharts.FullScreenfullscreenOpenCallbackFunction}
+ * @since 10.1.0
+ * @context   Highcharts.Chart
+ * @requires  modules/full-screen
+ * @apioption chart.events.fullscreenOpen
+ */
+(''); // keeps doclets above in transpiled file