highcharts 8.1.0 → 8.2.2

package/modules/export-data.src.js

@@ -1,5 +1,5 @@
 /**
- * @license Highcharts JS v8.1.0 (2020-05-05)
+ * @license Highcharts JS v8.2.2 (2020-10-22)
  *
  * Exporting module
  *
@@ -28,156 +28,7 @@
             obj[path] = fn.apply(null, args);
         }
     }
-    _registerModule(_modules, 'mixins/ajax.js', [_modules['parts/Globals.js'], _modules['parts/Utilities.js']], function (H, U) {
-        /* *
-         *
-         *  (c) 2010-2017 Christer Vasseng, Torstein Honsi
-         *
-         *  License: www.highcharts.com/license
-         *
-         *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
-         *
-         * */
-        var merge = U.merge,
-            objectEach = U.objectEach;
-        /**
-         * @interface Highcharts.AjaxSettingsObject
-         */ /**
-        * The payload to send.
-        *
-        * @name Highcharts.AjaxSettingsObject#data
-        * @type {string|Highcharts.Dictionary<any>}
-        */ /**
-        * The data type expected.
-        * @name Highcharts.AjaxSettingsObject#dataType
-        * @type {"json"|"xml"|"text"|"octet"}
-        */ /**
-        * Function to call on error.
-        * @name Highcharts.AjaxSettingsObject#error
-        * @type {Function}
-        */ /**
-        * The headers; keyed on header name.
-        * @name Highcharts.AjaxSettingsObject#headers
-        * @type {Highcharts.Dictionary<string>}
-        */ /**
-        * Function to call on success.
-        * @name Highcharts.AjaxSettingsObject#success
-        * @type {Function}
-        */ /**
-        * The verb to use.
-        * @name Highcharts.AjaxSettingsObject#type
-        * @type {"GET"|"POST"|"UPDATE"|"DELETE"}
-        */ /**
-        * The URL to call.
-        * @name Highcharts.AjaxSettingsObject#url
-        * @type {string}
-        */
-        /**
-         * Perform an Ajax call.
-         *
-         * @function Highcharts.ajax
-         *
-         * @param {Partial<Highcharts.AjaxSettingsObject>} attr
-         *        The Ajax settings to use.
-         *
-         * @return {false|undefined}
-         *         Returns false, if error occured.
-         */
-        H.ajax = function (attr) {
-            var options = merge(true, {
-                    url: false,
-                    type: 'get',
-                    dataType: 'json',
-                    success: false,
-                    error: false,
-                    data: false,
-                    headers: {}
-                },
-                attr),
-                headers = {
-                    json: 'application/json',
-                    xml: 'application/xml',
-                    text: 'text/plain',
-                    octet: 'application/octet-stream'
-                },
-                r = new XMLHttpRequest();
-            /**
-             * @private
-             * @param {XMLHttpRequest} xhr - Internal request object.
-             * @param {string|Error} err - Occured error.
-             * @return {void}
-             */
-            function handleError(xhr, err) {
-                if (options.error) {
-                    options.error(xhr, err);
-                }
-                else {
-                    // @todo Maybe emit a highcharts error event here
-                }
-            }
-            if (!options.url) {
-                return false;
-            }
-            r.open(options.type.toUpperCase(), options.url, true);
-            if (!options.headers['Content-Type']) {
-                r.setRequestHeader('Content-Type', headers[options.dataType] || headers.text);
-            }
-            objectEach(options.headers, function (val, key) {
-                r.setRequestHeader(key, val);
-            });
-            // @todo lacking timeout handling
-            r.onreadystatechange = function () {
-                var res;
-                if (r.readyState === 4) {
-                    if (r.status === 200) {
-                        res = r.responseText;
-                        if (options.dataType === 'json') {
-                            try {
-                                res = JSON.parse(res);
-                            }
-                            catch (e) {
-                                return handleError(r, e);
-                            }
-                        }
-                        return options.success && options.success(res);
-                    }
-                    handleError(r, r.responseText);
-                }
-            };
-            try {
-                options.data = JSON.stringify(options.data);
-            }
-            catch (e) {
-                // empty
-            }
-            r.send(options.data || true);
-        };
-        /**
-         * Get a JSON resource over XHR, also supporting CORS without preflight.
-         *
-         * @function Highcharts.getJSON
-         * @param {string} url
-         *        The URL to load.
-         * @param {Function} success
-         *        The success callback. For error handling, use the `Highcharts.ajax`
-         *        function instead.
-         * @return {void}
-         */
-        H.getJSON = function (url, success) {
-            H.ajax({
-                url: url,
-                success: success,
-                dataType: 'json',
-                headers: {
-                    // Override the Content-Type to avoid preflight problems with CORS
-                    // in the Highcharts demos
-                    'Content-Type': 'text/plain'
-                }
-            });
-        };
-
-    });
-    _registerModule(_modules, 'mixins/download-url.js', [_modules['parts/Globals.js']], function (Highcharts) {
+    _registerModule(_modules, 'Extensions/DownloadURL.js', [_modules['Core/Globals.js']], function (Highcharts) {
         /* *
          *
          *  (c) 2015-2020 Oystein Moseng
@@ -203,8 +54,10 @@
          * @return {string|undefined}
          *         Blob
          */
-        Highcharts.dataURLtoBlob = function (dataURL) {
-            var parts = dataURL.match(/data:([^;]*)(;base64)?,([0-9A-Za-z+/]+)/);
+        var dataURLtoBlob = Highcharts.dataURLtoBlob = function (dataURL) {
+                var parts = dataURL
+                    .replace(/filename=.*;/, '')
+                    .match(/data:([^;]*)(;base64)?,([0-9A-Za-z+/]+)/);
             if (parts &&
                 parts.length > 3 &&
                 win.atob &&
@@ -215,12 +68,11 @@
                 // Try to convert data URL to Blob
                 var binStr = win.atob(parts[3]),
                     buf = new win.ArrayBuffer(binStr.length),
-                    binary = new win.Uint8Array(buf),
-                    blob;
+                    binary = new win.Uint8Array(buf);
                 for (var i = 0; i < binary.length; ++i) {
                     binary[i] = binStr.charCodeAt(i);
                 }
-                blob = new win.Blob([binary], { 'type': parts[1] });
+                var blob = new win.Blob([binary], { 'type': parts[1] });
                 return domurl.createObjectURL(blob);
             }
         };
@@ -235,9 +87,10 @@
          *        The name of the resulting file (w/extension)
          * @return {void}
          */
-        Highcharts.downloadURL = function (dataURL, filename) {
-            var a = doc.createElement('a'),
-                windowRef;
+        var downloadURL = Highcharts.downloadURL = function (dataURL,
+            filename) {
+                var a = doc.createElement('a'),
+            windowRef;
             // IE specific blob implementation
             // Don't use for normal dataURLs
             if (typeof dataURL !== 'string' &&
@@ -246,10 +99,11 @@
                 nav.msSaveOrOpenBlob(dataURL, filename);
                 return;
             }
+            dataURL = "" + dataURL;
             // Some browsers have limitations for data URL lengths. Try to convert to
             // Blob or fall back. Edge always needs that blob.
             if (isEdgeBrowser || dataURL.length > 2000000) {
-                dataURL = Highcharts.dataURLtoBlob(dataURL);
+                dataURL = dataURLtoBlob(dataURL) || '';
                 if (!dataURL) {
                     throw new Error('Failed to convert to blob');
                 }
@@ -276,9 +130,14 @@
                 }
             }
         };
+        var exports = {
+                dataURLtoBlob: dataURLtoBlob,
+                downloadURL: downloadURL
+            };
 
+        return exports;
     });
-    _registerModule(_modules, 'modules/export-data.src.js', [_modules['parts/Globals.js'], _modules['parts/Utilities.js']], function (Highcharts, U) {
+    _registerModule(_modules, 'Extensions/ExportData.js', [_modules['Core/Axis/Axis.js'], _modules['Core/Chart/Chart.js'], _modules['Core/Globals.js'], _modules['Core/Utilities.js'], _modules['Extensions/DownloadURL.js']], function (Axis, Chart, H, U, DownloadURL) {
         /* *
          *
          *  Experimental data export module for Highcharts
@@ -293,6 +152,18 @@
         // @todo
         // - Set up systematic tests for all series types, paired with tests of the data
         //   module importing the same data.
+        var doc = H.doc,
+            seriesTypes = H.seriesTypes,
+            win = H.win;
+        var addEvent = U.addEvent,
+            defined = U.defined,
+            extend = U.extend,
+            find = U.find,
+            fireEvent = U.fireEvent,
+            getOptions = U.getOptions,
+            isNumber = U.isNumber,
+            pick = U.pick,
+            setOptions = U.setOptions;
         /**
          * Function callback to execute while data rows are processed for exporting.
          * This allows the modification of data rows before processed into the final
@@ -316,15 +187,7 @@
         * @name Highcharts.ExportDataEventObject#dataRows
         * @type {Array<Array<string>>}
         */
-        var defined = U.defined,
-            extend = U.extend,
-            isObject = U.isObject,
-            pick = U.pick;
-        var win = Highcharts.win,
-            doc = win.document,
-            seriesTypes = Highcharts.seriesTypes,
-            downloadURL = Highcharts.downloadURL,
-            fireEvent = Highcharts.fireEvent;
+        var downloadURL = DownloadURL.downloadURL;
         // Can we add this to utils? Also used in screen-reader.js
         /**
          * HTML encode some characters vulnerable for XSS.
@@ -341,7 +204,7 @@
                 .replace(/'/g, '&#x27;')
                 .replace(/\//g, '&#x2F;');
         }
-        Highcharts.setOptions({
+        setOptions({
             /**
              * Callback that fires while exporting data. This allows the modification of
              * data rows before processed into the final format.
@@ -402,6 +265,37 @@
                  * @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)
@@ -523,6 +417,10 @@
                  * @requires modules/export-data
                  */
                 exportData: {
+                    /**
+                     * The annotation column title.
+                     */
+                    annotationHeader: 'Annotations',
                     /**
                      * The category column title.
                      */
@@ -538,16 +436,24 @@
                  * @since    6.0.0
                  * @requires modules/export-data
                  */
-                viewData: 'View data table'
+                viewData: 'View data table',
+                /**
+                 * The text for the menu item.
+                 *
+                 * @since 8.2.0
+                 * @requires modules/export-data
+                 */
+                hideData: 'Hide data table'
             }
         });
         /* eslint-disable no-invalid-this */
         // Add an event listener to handle the showTable option
-        Highcharts.addEvent(Highcharts.Chart, 'render', function () {
+        addEvent(Chart, 'render', function () {
             if (this.options &&
                 this.options.exporting &&
                 this.options.exporting.showTable &&
-                !this.options.chart.forExport) {
+                !this.options.chart.forExport &&
+                !this.dataTableDiv) {
                 this.viewData();
             }
         });
@@ -561,7 +467,7 @@
          * @private
          * @function Highcharts.Chart#setUpKeyToAxis
          */
-        Highcharts.Chart.prototype.setUpKeyToAxis = function () {
+        Chart.prototype.setUpKeyToAxis = function () {
             if (seriesTypes.arearange) {
                 seriesTypes.arearange.prototype.keyToAxis = {
                     low: 'y',
@@ -591,7 +497,7 @@
          *
          * @fires Highcharts.Chart#event:exportData
          */
-        Highcharts.Chart.prototype.getDataRows = function (multiLevelHeaders) {
+        Chart.prototype.getDataRows = function (multiLevelHeaders) {
             var hasParallelCoords = this.hasParallelCoordinates,
                 time = this.time,
                 csvOptions = ((this.options.exporting && this.options.exporting.csv) || {}),
@@ -625,7 +531,7 @@
                 if (!item) {
                     return categoryHeader;
                 }
-                if (item instanceof Highcharts.Axis) {
+                if (item instanceof Axis) {
                     return (item.options.title && item.options.title.text) ||
                         (item.dateTime ? categoryDatetimeHeader : categoryHeader);
                 }
@@ -648,7 +554,7 @@
                             prop) + 'Axis', 
                         // Points in parallel coordinates refers to all yAxis
                         // not only `series.yAxis`
-                        axis = Highcharts.isNumber(pIdx) ?
+                        axis = isNumber(pIdx) ?
                             series.chart[axisName][pIdx] :
                             series[axisName];
                     categoryMap[prop] = (axis && axis.categories) || [];
@@ -658,6 +564,27 @@
                     categoryMap: categoryMap,
                     dateTimeValueAxisMap: dateTimeValueAxisMap
                 };
+            }, 
+            // Create point array depends if xAxis is category
+            // or point.name is defined #13293
+            getPointArray = function (series, xAxis) {
+                var namedPoints = series.data.filter(function (d) {
+                        return (typeof d.y !== 'undefined') && d.name;
+                });
+                if (namedPoints.length &&
+                    xAxis &&
+                    !xAxis.categories &&
+                    !series.keyToAxis) {
+                    if (series.pointArrayMap) {
+                        var pointArrayMapCheck = series.pointArrayMap.filter(function (p) { return p === 'x'; });
+                        if (pointArrayMapCheck.length) {
+                            series.pointArrayMap.unshift('x');
+                            return series.pointArrayMap;
+                        }
+                    }
+                    return ['x', 'y'];
+                }
+                return series.pointArrayMap || ['y'];
             }, xAxisIndices = [];
             // Loop the series and index values
             i = 0;
@@ -665,7 +592,8 @@
             this.series.forEach(function (series) {
                 var keys = series.options.keys,
                     xAxis = series.xAxis,
-                    pointArrayMap = keys || series.pointArrayMap || ['y'],
+                    pointArrayMap = keys || getPointArray(series,
+                    xAxis),
                     valueCount = pointArrayMap.length,
                     xTaken = !series.requireSorting && {},
                     xAxisIndex = xAxes.indexOf(xAxis),
@@ -680,7 +608,7 @@
                     // Build a lookup for X axis index and the position of the first
                     // series that belongs to that X axis. Includes -1 for non-axis
                     // series types like pies.
-                    if (!Highcharts.find(xAxisIndices, function (index) {
+                    if (!find(xAxisIndices, function (index) {
                         return index[0] === xAxisIndex;
                     })) {
                         xAxisIndices.push([xAxisIndex, i]);
@@ -724,7 +652,7 @@
                         // Pies, funnels, geo maps etc. use point name in X row
                         if (!xAxis ||
                             series.exportKey === 'name' ||
-                            (!hasParallelCoords && xAxis && xAxis.hasNames)) {
+                            (!hasParallelCoords && xAxis && xAxis.hasNames) && name) {
                             key = name;
                         }
                         if (xTaken) {
@@ -828,7 +756,7 @@
          * @return {string}
          *         CSV representation of the data
          */
-        Highcharts.Chart.prototype.getCSV = function (useLocalDecimalPoint) {
+        Chart.prototype.getCSV = function (useLocalDecimalPoint) {
             var csv = '', rows = this.getDataRows(), csvOptions = this.options.exporting.csv, decimalPoint = pick(csvOptions.decimalPoint, csvOptions.itemDelimiter !== ',' && useLocalDecimalPoint ?
                     (1.1).toLocaleString()[1] :
                     '.'), 
@@ -880,7 +808,7 @@
          *
          * @fires Highcharts.Chart#event:afterGetTable
          */
-        Highcharts.Chart.prototype.getTable = function (useLocalDecimalPoint) {
+        Chart.prototype.getTable = function (useLocalDecimalPoint) {
             var html = '<table id="highcharts-data-table-' + this.index + '">', options = this.options, decimalPoint = useLocalDecimalPoint ? (1.1).toLocaleString()[1] : '.', useMultiLevelHeaders = pick(options.exporting.useMultiLevelHeaders, true), rows = this.getDataRows(useMultiLevelHeaders), rowLength = 0, topHeaders = useMultiLevelHeaders ? rows.shift() : null, subHeaders = rows.shift(), 
                 // Compare two rows for equality
                 isRowEqual = function (row1, row2) {
@@ -1058,7 +986,7 @@
          *
          * @requires modules/exporting
          */
-        Highcharts.Chart.prototype.downloadCSV = function () {
+        Chart.prototype.downloadCSV = function () {
             var csv = this.getCSV(true);
             downloadURL(getBlobFromContent(csv, 'text/csv') ||
                 'data:text/csv,\uFEFF' + encodeURIComponent(csv), this.getFilename() + '.csv');
@@ -1073,7 +1001,7 @@
          *
          * @requires modules/exporting
          */
-        Highcharts.Chart.prototype.downloadXLS = function () {
+        Chart.prototype.downloadXLS = function () {
             var uri = 'data:application/vnd.ms-excel;base64,', template = '<html xmlns:o="urn:schemas-microsoft-com:office:office" ' +
                     'xmlns:x="urn:schemas-microsoft-com:office:excel" ' +
                     'xmlns="http://www.w3.org/TR/REC-html40">' +
@@ -1103,18 +1031,56 @@
          *
          * @fires Highcharts.Chart#event:afterViewData
          */
-        Highcharts.Chart.prototype.viewData = function () {
+        Chart.prototype.viewData = function () {
+            // Create div and generate the data table.
             if (!this.dataTableDiv) {
                 this.dataTableDiv = doc.createElement('div');
                 this.dataTableDiv.className = 'highcharts-data-table';
                 // Insert after the chart container
                 this.renderTo.parentNode.insertBefore(this.dataTableDiv, this.renderTo.nextSibling);
+                this.dataTableDiv.innerHTML = this.getTable();
             }
-            this.dataTableDiv.innerHTML = this.getTable();
+            // Show the data table again.
+            if (this.dataTableDiv.style.display === '' || this.dataTableDiv.style.display === 'none') {
+                this.dataTableDiv.style.display = 'block';
+            }
+            this.isDataTableVisible = true;
             fireEvent(this, 'afterViewData', this.dataTableDiv);
         };
+        /**
+         * Export-data module required. Hide the data table when visible.
+         *
+         * @function Highcharts.Chart#hideData
+         */
+        Chart.prototype.hideData = function () {
+            if (this.dataTableDiv && this.dataTableDiv.style.display === 'block') {
+                this.dataTableDiv.style.display = 'none';
+            }
+            this.isDataTableVisible = false;
+        };
+        Chart.prototype.toggleDataTable = function () {
+            var exportDivElements = this.exportDivElements,
+                options = this.options.exporting,
+                menuItems = options && options.buttons && options.buttons.contextButton.menuItems,
+                lang = this.options.lang;
+            if (this.isDataTableVisible) {
+                this.hideData();
+            }
+            else {
+                this.viewData();
+            }
+            // Change the button text based on table visibility.
+            if ((exportingOptions === null || exportingOptions === void 0 ? void 0 : exportingOptions.menuItemDefinitions) && (lang === null || lang === void 0 ? void 0 : lang.viewData) &&
+                lang.hideData &&
+                menuItems &&
+                exportDivElements &&
+                exportDivElements.length) {
+                exportDivElements[menuItems.indexOf('viewData')]
+                    .innerHTML = this.isDataTableVisible ? lang.hideData : lang.viewData;
+            }
+        };
         // Add "Download CSV" to the exporting menu.
-        var exportingOptions = Highcharts.getOptions().exporting;
+        var exportingOptions = getOptions().exporting;
         if (exportingOptions) {
             extend(exportingOptions.menuItemDefinitions, {
                 downloadCSV: {
@@ -1132,7 +1098,7 @@
                 viewData: {
                     textKey: 'viewData',
                     onclick: function () {
-                        this.viewData();
+                        this.toggleDataTable();
                     }
                 }
             });

package/modules/exporting.d.ts

@@ -71,6 +71,8 @@ declare module "../highcharts" {
     }
     /**
      * Handles displaying chart's container in the fullscreen mode.
+     *
+     * **Note**: Fullscreen is not supported on iPhone due to iOS limitations.
      */
     class Fullscreen {
         /**