highcharts 10.0.0 → 10.2.1

package/es-modules/Extensions/ExportData/ExportDataDefaults.js

@@ -0,0 +1,272 @@
+/* *
+ *
+ *  Experimental data export module for Highcharts
+ *
+ *  (c) 2010-2021 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+/* *
+ *
+ *  Constants
+ *
+ * */
+/**
+ * @optionparent exporting
+ * @private
+ */
+var exporting = {
+    /**
+     * Caption for the data table. Same as chart title by default. Set to
+     * `false` to disable.
+     *
+     * @sample highcharts/export-data/multilevel-table
+     *         Multiple table headers
+     *
+     * @type      {boolean|string}
+     * @since     6.0.4
+     * @requires  modules/export-data
+     * @apioption exporting.tableCaption
+     */
+    /**
+     * Options for exporting data to CSV or ExCel, or displaying the data
+     * in a HTML table or a JavaScript structure.
+     *
+     * This module adds data export options to the export menu and provides
+     * functions like `Chart.getCSV`, `Chart.getTable`, `Chart.getDataRows`
+     * and `Chart.viewData`.
+     *
+     * The XLS converter is limited and only creates a HTML string that is
+     * passed for download, which works but creates a warning before
+     * opening. The workaround for this is to use a third party XLSX
+     * converter, as demonstrated in the sample below.
+     *
+     * @sample  highcharts/export-data/categorized/ Categorized data
+     * @sample  highcharts/export-data/stock-timeaxis/ Highcharts Stock time axis
+     * @sample  highcharts/export-data/xlsx/
+     *          Using a third party XLSX converter
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    csv: {
+        /**
+         *
+         * Options for annotations in the export-data table.
+         *
+         * @since 8.2.0
+         * @requires modules/export-data
+         * @requires modules/annotations
+         *
+         *
+         */
+        annotations: {
+            /**
+            * The way to mark the separator for annotations
+            * combined in one export-data table cell.
+            *
+            * @since 8.2.0
+            * @requires modules/annotations
+            */
+            itemDelimiter: '; ',
+            /**
+            * When several labels are assigned to a specific point,
+            * they will be displayed in one field in the table.
+            *
+            * @sample highcharts/export-data/join-annotations/
+            *         Concatenate point annotations with itemDelimiter set.
+            *
+            * @since 8.2.0
+            * @requires modules/annotations
+            */
+            join: false
+        },
+        /**
+         * Formatter callback for the column headers. Parameters are:
+         * - `item` - The series or axis object)
+         * - `key` -  The point key, for example y or z
+         * - `keyLength` - The amount of value keys for this item, for
+         *   example a range series has the keys `low` and `high` so the
+         *   key length is 2.
+         *
+         * If [useMultiLevelHeaders](#exporting.useMultiLevelHeaders) is
+         * true, columnHeaderFormatter by default returns an object with
+         * columnTitle and topLevelColumnTitle for each key. Columns with
+         * the same topLevelColumnTitle have their titles merged into a
+         * single cell with colspan for table/Excel export.
+         *
+         * If `useMultiLevelHeaders` is false, or for CSV export, it returns
+         * the series name, followed by the key if there is more than one
+         * key.
+         *
+         * For the axis it returns the axis title or "Category" or
+         * "DateTime" by default.
+         *
+         * Return `false` to use Highcharts' proposed header.
+         *
+         * @sample highcharts/export-data/multilevel-table
+         *         Multiple table headers
+         *
+         * @type {Function|null}
+         */
+        columnHeaderFormatter: null,
+        /**
+         * Which date format to use for exported dates on a datetime X axis.
+         * See `Highcharts.dateFormat`.
+         */
+        dateFormat: '%Y-%m-%d %H:%M:%S',
+        /**
+         * Which decimal point to use for exported CSV. Defaults to the same
+         * as the browser locale, typically `.` (English) or `,` (German,
+         * French etc).
+         *
+         * @type  {string|null}
+         * @since 6.0.4
+         */
+        decimalPoint: null,
+        /**
+         * The item delimiter in the exported data. Use `;` for direct
+         * exporting to Excel. Defaults to a best guess based on the browser
+         * locale. If the locale _decimal point_ is `,`, the `itemDelimiter`
+         * defaults to `;`, otherwise the `itemDelimiter` defaults to `,`.
+         *
+         * @type {string|null}
+         */
+        itemDelimiter: null,
+        /**
+         * The line delimiter in the exported data, defaults to a newline.
+         */
+        lineDelimiter: '\n'
+    },
+    /**
+     * Show a HTML table below the chart with the chart's current data.
+     *
+     * @sample highcharts/export-data/showtable/
+     *         Show the table
+     * @sample highcharts/studies/exporting-table-html
+     *         Experiment with putting the table inside the subtitle to
+     *         allow exporting it.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    showTable: false,
+    /**
+     * Use multi level headers in data table. If [csv.columnHeaderFormatter
+     * ](#exporting.csv.columnHeaderFormatter) is defined, it has to return
+     * objects in order for multi level headers to work.
+     *
+     * @sample highcharts/export-data/multilevel-table
+     *         Multiple table headers
+     *
+     * @since    6.0.4
+     * @requires modules/export-data
+     */
+    useMultiLevelHeaders: true,
+    /**
+     * If using multi level table headers, use rowspans for headers that
+     * have only one level.
+     *
+     * @sample highcharts/export-data/multilevel-table
+     *         Multiple table headers
+     *
+     * @since    6.0.4
+     * @requires modules/export-data
+     */
+    useRowspanHeaders: true
+};
+/**
+ * @optionparent lang
+ * @private
+ */
+var lang = {
+    /**
+     * The text for the menu item.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    downloadCSV: 'Download CSV',
+    /**
+     * The text for the menu item.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    downloadXLS: 'Download XLS',
+    /**
+     * The text for exported table.
+     *
+     * @since 8.1.0
+     * @requires modules/export-data
+     */
+    exportData: {
+        /**
+         * The annotation column title.
+         */
+        annotationHeader: 'Annotations',
+        /**
+         * The category column title.
+         */
+        categoryHeader: 'Category',
+        /**
+         * The category column title when axis type set to "datetime".
+         */
+        categoryDatetimeHeader: 'DateTime'
+    },
+    /**
+     * The text for the menu item.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    viewData: 'View data table',
+    /**
+     * The text for the menu item.
+     *
+     * @since 8.2.0
+     * @requires modules/export-data
+     */
+    hideData: 'Hide data table'
+};
+/* *
+ *
+ *  Default Export
+ *
+ * */
+var ExportDataDefaults = {
+    exporting: exporting,
+    lang: lang
+};
+export default ExportDataDefaults;
+/* *
+ *
+ *  API Options
+ *
+ * */
+/**
+ * Callback that fires while exporting data. This allows the modification of
+ * data rows before processed into the final format.
+ *
+ * @type      {Highcharts.ExportDataCallbackFunction}
+ * @context   Highcharts.Chart
+ * @requires  modules/export-data
+ * @apioption chart.events.exportData
+ */
+/**
+ * When set to `false` will prevent the series data from being included in
+ * any form of data export.
+ *
+ * Since version 6.0.0 until 7.1.0 the option was existing undocumented
+ * as `includeInCSVExport`.
+ *
+ * @type      {boolean}
+ * @since     7.1.0
+ * @requires  modules/export-data
+ * @apioption plotOptions.series.includeInDataExport
+ */
+(''); // keep doclets above in JS file

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

@@ -17,8 +17,9 @@ import D from '../../Core/DefaultOptions.js';
 var defaultOptions = D.defaultOptions;
 import ExportingDefaults from './ExportingDefaults.js';
 import ExportingSymbols from './ExportingSymbols.js';
+import Fullscreen from './Fullscreen.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 +104,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.fill = pick(attr.fill, "#ffffff" /* Palette.backgroundColor */);
             attr.stroke = pick(attr.stroke, 'none');
         }
-        delete attr.states;
         if (onclick) {
             callback = function (e) {
                 if (e) {
@@ -140,11 +140,11 @@ var Exporting;
         }
         if (!chart.styledMode) {
             attr['stroke-linecap'] = 'round';
-            attr.fill = pick(attr.fill, "#ffffff" /* backgroundColor */);
+            attr.fill = pick(attr.fill, "#ffffff" /* Palette.backgroundColor */);
             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], '')
@@ -308,6 +308,7 @@ var Exporting;
      */
     function compose(ChartClass, SVGRendererClass) {
         ExportingSymbols.compose(SVGRendererClass);
+        Fullscreen.compose(ChartClass);
         if (composedClasses.indexOf(ChartClass) === -1) {
             composedClasses.push(ChartClass);
             var chartProto = ChartClass.prototype;
@@ -825,10 +826,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 +837,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.
@@ -882,13 +886,14 @@ var Exporting;
                             }
                             // Styles
                         }
-                        else {
-                            cssText += hyphenate(prop) + ':' + val + ';';
+                        else if (prop !== 'parentRule') {
+                            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' ?
@@ -929,10 +934,16 @@ var Exporting;
                     }
                 }
                 // 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');
@@ -947,7 +958,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
@@ -1004,7 +1015,7 @@ var Exporting;
                 update('exporting', options, redraw);
             }
         };
-        // Register update() method for navigation. Can not be set the same way
+        // Register update() method for navigation. Cannot be set the same way
         // as for exporting, because navigation options are shared with bindings
         // which has separate update() logic.
         ChartNavigationComposition
@@ -1148,6 +1159,8 @@ defaultOptions.lang = merge(ExportingDefaults.lang, defaultOptions.lang);
  *
  * @requires     modules/exporting
  * @optionparent navigation
+ *
+ * @private
  */
 defaultOptions.navigation = merge(ExportingDefaults.navigation, defaultOptions.navigation);
 /* *

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

@@ -429,7 +429,9 @@ var exporting = {
         viewFullscreen: {
             textKey: 'viewFullscreen',
             onclick: function () {
-                this.fullscreen.toggle();
+                if (this.fullscreen) {
+                    this.fullscreen.toggle();
+                }
             }
         },
         /**
@@ -700,7 +702,7 @@ var navigation = {
          * @type  {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
          * @since 2.0
          */
-        symbolFill: "#666666" /* neutralColor60 */,
+        symbolFill: "#666666" /* Palette.neutralColor60 */,
         /**
          * The color of the symbol's stroke or line.
          *
@@ -710,7 +712,7 @@ var navigation = {
          * @type  {Highcharts.ColorString}
          * @since 2.0
          */
-        symbolStroke: "#666666" /* neutralColor60 */,
+        symbolStroke: "#666666" /* Palette.neutralColor60 */,
         /**
          * The pixel stroke width of the symbol on the button.
          *
@@ -771,9 +773,9 @@ var navigation = {
      */
     menuStyle: {
         /** @ignore-option */
-        border: "1px solid " + "#999999" /* neutralColor40 */,
+        border: "1px solid ".concat("#999999" /* Palette.neutralColor40 */),
         /** @ignore-option */
-        background: "#ffffff" /* backgroundColor */,
+        background: "#ffffff" /* Palette.backgroundColor */,
         /** @ignore-option */
         padding: '5px 0'
     },
@@ -799,7 +801,7 @@ var navigation = {
         /** @ignore-option */
         padding: '0.5em 1em',
         /** @ignore-option */
-        color: "#333333" /* neutralColor80 */,
+        color: "#333333" /* Palette.neutralColor80 */,
         /** @ignore-option */
         background: 'none',
         /** @ignore-option */
@@ -826,9 +828,9 @@ var navigation = {
      */
     menuItemHoverStyle: {
         /** @ignore-option */
-        background: "#335cad" /* highlightColor80 */,
+        background: "#335cad" /* Palette.highlightColor80 */,
         /** @ignore-option */
-        color: "#ffffff" /* backgroundColor */
+        color: "#ffffff" /* Palette.backgroundColor */
     }
 };
 /* *