| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152 |
- /* *
- *
- * (c) 2010-2021 Torstein Honsi
- *
- * License: www.highcharts.com/license
- *
- * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
- 'use strict';
- import H from './Globals.js';
- var charts = H.charts, doc = H.doc, win = H.win;
- /**
- * An animation configuration. Animation configurations can also be defined as
- * booleans, where `false` turns off animation and `true` defaults to a duration
- * of 500ms and defer of 0ms.
- *
- * @interface Highcharts.AnimationOptionsObject
- */ /**
- * A callback function to exectute when the animation finishes.
- * @name Highcharts.AnimationOptionsObject#complete
- * @type {Function|undefined}
- */ /**
- * The animation defer in milliseconds.
- * @name Highcharts.AnimationOptionsObject#defer
- * @type {number|undefined}
- */ /**
- * The animation duration in milliseconds.
- * @name Highcharts.AnimationOptionsObject#duration
- * @type {number|undefined}
- */ /**
- * The name of an easing function as defined on the `Math` object.
- * @name Highcharts.AnimationOptionsObject#easing
- * @type {string|Function|undefined}
- */ /**
- * A callback function to execute on each step of each attribute or CSS property
- * that's being animated. The first argument contains information about the
- * animation and progress.
- * @name Highcharts.AnimationOptionsObject#step
- * @type {Function|undefined}
- */
- /**
- * Creates a frame for the animated SVG element.
- *
- * @callback Highcharts.AnimationStepCallbackFunction
- *
- * @param {Highcharts.SVGElement} this
- * The SVG element to animate.
- *
- * @return {void}
- */
- /**
- * Interface description for a class.
- *
- * @interface Highcharts.Class<T>
- * @extends Function
- */ /**
- * Class costructor.
- * @function Highcharts.Class<T>#new
- * @param {...Array<*>} args
- * Constructor arguments.
- * @return {T}
- * Class instance.
- */
- /**
- * A style object with camel case property names to define visual appearance of
- * a SVG element or HTML element. The properties can be whatever styles are
- * supported on the given SVG or HTML element.
- *
- * @example
- * {
- * fontFamily: 'monospace',
- * fontSize: '1.2em'
- * }
- *
- * @interface Highcharts.CSSObject
- */ /**
- * @name Highcharts.CSSObject#[key:string]
- * @type {boolean|number|string|undefined}
- */ /**
- * Background style for the element.
- * @name Highcharts.CSSObject#background
- * @type {string|undefined}
- */ /**
- * Background color of the element.
- * @name Highcharts.CSSObject#backgroundColor
- * @type {Highcharts.ColorString|undefined}
- */ /**
- * Border style for the element.
- * @name Highcharts.CSSObject#border
- * @type {string|undefined}
- */ /**
- * Radius of the element border.
- * @name Highcharts.CSSObject#borderRadius
- * @type {number|undefined}
- */ /**
- * Color used in the element. The 'contrast' option is a Highcharts custom
- * property that results in black or white, depending on the background of the
- * element.
- * @name Highcharts.CSSObject#color
- * @type {'contrast'|Highcharts.ColorString|undefined}
- */ /**
- * Style of the mouse cursor when resting over the element.
- * @name Highcharts.CSSObject#cursor
- * @type {Highcharts.CursorValue|undefined}
- */ /**
- * Font family of the element text. Multiple values have to be in decreasing
- * preference order and separated by comma.
- * @name Highcharts.CSSObject#fontFamily
- * @type {string|undefined}
- */ /**
- * Font size of the element text.
- * @name Highcharts.CSSObject#fontSize
- * @type {string|undefined}
- */ /**
- * Font weight of the element text.
- * @name Highcharts.CSSObject#fontWeight
- * @type {string|undefined}
- */ /**
- * Height of the element.
- * @name Highcharts.CSSObject#height
- * @type {number|undefined}
- */ /**
- * Width of the element border.
- * @name Highcharts.CSSObject#lineWidth
- * @type {number|undefined}
- */ /**
- * Opacity of the element.
- * @name Highcharts.CSSObject#opacity
- * @type {number|undefined}
- */ /**
- * Space around the element content.
- * @name Highcharts.CSSObject#padding
- * @type {string|undefined}
- */ /**
- * Behaviour of the element when the mouse cursor rests over it.
- * @name Highcharts.CSSObject#pointerEvents
- * @type {string|undefined}
- */ /**
- * Positioning of the element.
- * @name Highcharts.CSSObject#position
- * @type {string|undefined}
- */ /**
- * Alignment of the element text.
- * @name Highcharts.CSSObject#textAlign
- * @type {string|undefined}
- */ /**
- * Additional decoration of the element text.
- * @name Highcharts.CSSObject#textDecoration
- * @type {string|undefined}
- */ /**
- * Outline style of the element text.
- * @name Highcharts.CSSObject#textOutline
- * @type {string|undefined}
- */ /**
- * Line break style of the element text. Highcharts SVG elements support
- * `ellipsis` when a `width` is set.
- * @name Highcharts.CSSObject#textOverflow
- * @type {string|undefined}
- */ /**
- * Top spacing of the element relative to the parent element.
- * @name Highcharts.CSSObject#top
- * @type {string|undefined}
- */ /**
- * Animated transition of selected element properties.
- * @name Highcharts.CSSObject#transition
- * @type {string|undefined}
- */ /**
- * Line break style of the element text.
- * @name Highcharts.CSSObject#whiteSpace
- * @type {string|undefined}
- */ /**
- * Width of the element.
- * @name Highcharts.CSSObject#width
- * @type {number|undefined}
- */
- /**
- * All possible cursor styles.
- *
- * @typedef {'alias'|'all-scroll'|'auto'|'cell'|'col-resize'|'context-menu'|'copy'|'crosshair'|'default'|'e-resize'|'ew-resize'|'grab'|'grabbing'|'help'|'move'|'n-resize'|'ne-resize'|'nesw-resize'|'no-drop'|'none'|'not-allowed'|'ns-resize'|'nw-resize'|'nwse-resize'|'pointer'|'progress'|'row-resize'|'s-resize'|'se-resize'|'sw-resize'|'text'|'vertical-text'|'w-resize'|'wait'|'zoom-in'|'zoom-out'} Highcharts.CursorValue
- */
- /**
- * All possible dash styles.
- *
- * @typedef {'Dash'|'DashDot'|'Dot'|'LongDash'|'LongDashDot'|'LongDashDotDot'|'ShortDash'|'ShortDashDot'|'ShortDashDotDot'|'ShortDot'|'Solid'} Highcharts.DashStyleValue
- */
- /**
- * Generic dictionary in TypeScript notation.
- * Use the native `Record<string, any>` instead.
- *
- * @deprecated
- * @interface Highcharts.Dictionary<T>
- */ /**
- * @name Highcharts.Dictionary<T>#[key:string]
- * @type {T}
- */
- /**
- * The function callback to execute when the event is fired. The `this` context
- * contains the instance, that fired the event.
- *
- * @callback Highcharts.EventCallbackFunction<T>
- *
- * @param {T} this
- *
- * @param {Highcharts.Dictionary<*>|Event} [eventArguments]
- * Event arguments.
- *
- * @return {boolean|void}
- */
- /**
- * The event options for adding function callback.
- *
- * @interface Highcharts.EventOptionsObject
- */ /**
- * The order the event handler should be called. This opens for having one
- * handler be called before another, independent of in which order they were
- * added.
- * @name Highcharts.EventOptionsObject#order
- * @type {number}
- */ /**
- * Whether an event should be passive or not.
- * When set to `true`, the function specified by listener will never call
- * `preventDefault()`.
- * @name Highcharts.EventOptionsObject#passive
- * @type boolean
- */
- /**
- * Formats data as a string. Usually the data is accessible throught the `this`
- * keyword.
- *
- * @callback Highcharts.FormatterCallbackFunction<T>
- *
- * @param {T} this
- * Context to format
- *
- * @return {string}
- * Formatted text
- */
- /**
- * An object of key-value pairs for HTML attributes.
- *
- * @typedef {Highcharts.Dictionary<boolean|number|string|Function>} Highcharts.HTMLAttributes
- */
- /**
- * An HTML DOM element. The type is a reference to the regular HTMLElement in
- * the global scope.
- *
- * @typedef {global.HTMLElement} Highcharts.HTMLDOMElement
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement
- */
- /**
- * The iterator callback.
- *
- * @callback Highcharts.ObjectEachCallbackFunction<T>
- *
- * @param {T} this
- * The context.
- *
- * @param {*} value
- * The property value.
- *
- * @param {string} key
- * The property key.
- *
- * @param {*} obj
- * The object that objectEach is being applied to.
- */
- /**
- * An object containing `left` and `top` properties for the position in the
- * page.
- *
- * @interface Highcharts.OffsetObject
- */ /**
- * Left distance to the page border.
- * @name Highcharts.OffsetObject#left
- * @type {number}
- */ /**
- * Top distance to the page border.
- * @name Highcharts.OffsetObject#top
- * @type {number}
- */
- /**
- * Describes a range.
- *
- * @interface Highcharts.RangeObject
- */ /**
- * Maximum number of the range.
- * @name Highcharts.RangeObject#max
- * @type {number}
- */ /**
- * Minimum number of the range.
- * @name Highcharts.RangeObject#min
- * @type {number}
- */
- /**
- * If a number is given, it defines the pixel length. If a percentage string is
- * given, like for example `'50%'`, the setting defines a length relative to a
- * base size, for example the size of a container.
- *
- * @typedef {number|string} Highcharts.RelativeSize
- */
- /**
- * Proceed function to call original (wrapped) function.
- *
- * @callback Highcharts.WrapProceedFunction
- *
- * @param {*} [arg1]
- * Optional argument. Without any arguments defaults to first argument of
- * the wrapping function.
- *
- * @param {*} [arg2]
- * Optional argument. Without any arguments defaults to second argument
- * of the wrapping function.
- *
- * @param {*} [arg3]
- * Optional argument. Without any arguments defaults to third argument of
- * the wrapping function.
- *
- * @return {*}
- * Return value of the original function.
- */
- /**
- * The Highcharts object is the placeholder for all other members, and various
- * utility functions. The most important member of the namespace would be the
- * chart constructor.
- *
- * @example
- * var chart = Highcharts.chart('container', { ... });
- *
- * @namespace Highcharts
- */
- ''; // detach doclets above
- /**
- * Provide error messages for debugging, with links to online explanation. This
- * function can be overridden to provide custom error handling.
- *
- * @sample highcharts/chart/highcharts-error/
- * Custom error handler
- *
- * @function Highcharts.error
- *
- * @param {number|string} code
- * The error code. See
- * [errors.xml](https://github.com/highcharts/highcharts/blob/master/errors/errors.xml)
- * for available codes. If it is a string, the error message is printed
- * directly in the console.
- *
- * @param {boolean} [stop=false]
- * Whether to throw an error or just log a warning in the console.
- *
- * @param {Highcharts.Chart} [chart]
- * Reference to the chart that causes the error. Used in 'debugger'
- * module to display errors directly on the chart.
- * Important note: This argument is undefined for errors that lack
- * access to the Chart instance.
- *
- * @param {Highcharts.Dictionary<string>} [params]
- * Additional parameters for the generated message.
- *
- * @return {void}
- */
- function error(code, stop, chart, params) {
- var severity = stop ? 'Highcharts error' : 'Highcharts warning';
- if (code === 32) {
- code = severity + ": Deprecated member";
- }
- var isCode = isNumber(code), message = isCode ?
- severity + " #" + code + ": www.highcharts.com/errors/" + code + "/" :
- code.toString(), defaultHandler = function () {
- if (stop) {
- throw new Error(message);
- }
- // else ...
- if (win.console &&
- error.messages.indexOf(message) === -1 // prevent console flooting
- ) {
- console.warn(message); // eslint-disable-line no-console
- }
- };
- if (typeof params !== 'undefined') {
- var additionalMessages_1 = '';
- if (isCode) {
- message += '?';
- }
- objectEach(params, function (value, key) {
- additionalMessages_1 += "\n - " + key + ": " + value;
- if (isCode) {
- message += encodeURI(key) + '=' + encodeURI(value);
- }
- });
- message += additionalMessages_1;
- }
- if (chart) {
- fireEvent(chart, 'displayError', { code: code, message: message, params: params }, defaultHandler);
- }
- else {
- defaultHandler();
- }
- error.messages.push(message);
- }
- (function (error) {
- error.messages = [];
- })(error || (error = {}));
- /* eslint-disable valid-jsdoc */
- /**
- * Utility function to deep merge two or more objects and return a third object.
- * If the first argument is true, the contents of the second object is copied
- * into the first object. The merge function can also be used with a single
- * object argument to create a deep copy of an object.
- *
- * @function Highcharts.merge<T>
- *
- * @param {boolean} extend
- * Whether to extend the left-side object (a) or return a whole new
- * object.
- *
- * @param {T|undefined} a
- * The first object to extend. When only this is given, the function
- * returns a deep copy.
- *
- * @param {...Array<object|undefined>} [n]
- * An object to merge into the previous one.
- *
- * @return {T}
- * The merged object. If the first argument is true, the return is the
- * same as the second argument.
- */ /**
- * Utility function to deep merge two or more objects and return a third object.
- * The merge function can also be used with a single object argument to create a
- * deep copy of an object.
- *
- * @function Highcharts.merge<T>
- *
- * @param {T|undefined} a
- * The first object to extend. When only this is given, the function
- * returns a deep copy.
- *
- * @param {...Array<object|undefined>} [n]
- * An object to merge into the previous one.
- *
- * @return {T}
- * The merged object. If the first argument is true, the return is the
- * same as the second argument.
- */
- function merge() {
- /* eslint-enable valid-jsdoc */
- var i, args = arguments, len, ret = {}, doCopy = function (copy, original) {
- // An object is replacing a primitive
- if (typeof copy !== 'object') {
- copy = {};
- }
- objectEach(original, function (value, key) {
- // Prototype pollution (#14883)
- if (key === '__proto__' || key === 'constructor') {
- return;
- }
- // Copy the contents of objects, but not arrays or DOM nodes
- if (isObject(value, true) &&
- !isClass(value) &&
- !isDOMElement(value)) {
- copy[key] = doCopy(copy[key] || {}, value);
- // Primitives and arrays are copied over directly
- }
- else {
- copy[key] = original[key];
- }
- });
- return copy;
- };
- // If first argument is true, copy into the existing object. Used in
- // setOptions.
- if (args[0] === true) {
- ret = args[1];
- args = Array.prototype.slice.call(args, 2);
- }
- // For each argument, extend the return
- len = args.length;
- for (i = 0; i < len; i++) {
- ret = doCopy(ret, args[i]);
- }
- return ret;
- }
- /**
- * Constrain a value to within a lower and upper threshold.
- *
- * @private
- * @param {number} value The initial value
- * @param {number} min The lower threshold
- * @param {number} max The upper threshold
- * @return {number} Returns a number value within min and max.
- */
- function clamp(value, min, max) {
- return value > min ? value < max ? value : max : min;
- }
- // eslint-disable-next-line valid-jsdoc
- /**
- * Remove settings that have not changed, to avoid unnecessary rendering or
- * computing (#9197).
- * @private
- */
- function cleanRecursively(newer, older) {
- var result = {};
- objectEach(newer, function (_val, key) {
- var ob;
- // Dive into objects (except DOM nodes)
- if (isObject(newer[key], true) &&
- !newer.nodeType && // #10044
- older[key]) {
- ob = cleanRecursively(newer[key], older[key]);
- if (Object.keys(ob).length) {
- result[key] = ob;
- }
- // Arrays, primitives and DOM nodes are copied directly
- }
- else if (isObject(newer[key]) ||
- newer[key] !== older[key]) {
- result[key] = newer[key];
- }
- });
- return result;
- }
- /**
- * Shortcut for parseInt
- *
- * @private
- * @function Highcharts.pInt
- *
- * @param {*} s
- * any
- *
- * @param {number} [mag]
- * Magnitude
- *
- * @return {number}
- * number
- */
- function pInt(s, mag) {
- return parseInt(s, mag || 10);
- }
- /**
- * Utility function to check for string type.
- *
- * @function Highcharts.isString
- *
- * @param {*} s
- * The item to check.
- *
- * @return {boolean}
- * True if the argument is a string.
- */
- function isString(s) {
- return typeof s === 'string';
- }
- /**
- * Utility function to check if an item is an array.
- *
- * @function Highcharts.isArray
- *
- * @param {*} obj
- * The item to check.
- *
- * @return {boolean}
- * True if the argument is an array.
- */
- function isArray(obj) {
- var str = Object.prototype.toString.call(obj);
- return str === '[object Array]' || str === '[object Array Iterator]';
- }
- /**
- * Utility function to check if an item is of type object.
- *
- * @function Highcharts.isObject
- *
- * @param {*} obj
- * The item to check.
- *
- * @param {boolean} [strict=false]
- * Also checks that the object is not an array.
- *
- * @return {boolean}
- * True if the argument is an object.
- */
- function isObject(obj, strict) {
- return (!!obj &&
- typeof obj === 'object' &&
- (!strict || !isArray(obj))); // eslint-disable-line @typescript-eslint/no-explicit-any
- }
- /**
- * Utility function to check if an Object is a HTML Element.
- *
- * @function Highcharts.isDOMElement
- *
- * @param {*} obj
- * The item to check.
- *
- * @return {boolean}
- * True if the argument is a HTML Element.
- */
- function isDOMElement(obj) {
- return isObject(obj) && typeof obj.nodeType === 'number';
- }
- /**
- * Utility function to check if an Object is a class.
- *
- * @function Highcharts.isClass
- *
- * @param {object|undefined} obj
- * The item to check.
- *
- * @return {boolean}
- * True if the argument is a class.
- */
- function isClass(obj) {
- var c = obj && obj.constructor;
- return !!(isObject(obj, true) &&
- !isDOMElement(obj) &&
- (c && c.name && c.name !== 'Object'));
- }
- /**
- * Utility function to check if an item is a number and it is finite (not NaN,
- * Infinity or -Infinity).
- *
- * @function Highcharts.isNumber
- *
- * @param {*} n
- * The item to check.
- *
- * @return {boolean}
- * True if the item is a finite number
- */
- function isNumber(n) {
- return typeof n === 'number' && !isNaN(n) && n < Infinity && n > -Infinity;
- }
- /**
- * Remove the last occurence of an item from an array.
- *
- * @function Highcharts.erase
- *
- * @param {Array<*>} arr
- * The array.
- *
- * @param {*} item
- * The item to remove.
- *
- * @return {void}
- */
- function erase(arr, item) {
- var i = arr.length;
- while (i--) {
- if (arr[i] === item) {
- arr.splice(i, 1);
- break;
- }
- }
- }
- /**
- * Check if an object is null or undefined.
- *
- * @function Highcharts.defined
- *
- * @param {*} obj
- * The object to check.
- *
- * @return {boolean}
- * False if the object is null or undefined, otherwise true.
- */
- function defined(obj) {
- return typeof obj !== 'undefined' && obj !== null;
- }
- /**
- * Set or get an attribute or an object of attributes. To use as a setter, pass
- * a key and a value, or let the second argument be a collection of keys and
- * values. To use as a getter, pass only a string as the second argument.
- *
- * @function Highcharts.attr
- *
- * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} elem
- * The DOM element to receive the attribute(s).
- *
- * @param {string|Highcharts.HTMLAttributes|Highcharts.SVGAttributes} [prop]
- * The property or an object of key-value pairs.
- *
- * @param {number|string} [value]
- * The value if a single property is set.
- *
- * @return {string|null|undefined}
- * When used as a getter, return the value.
- */
- function attr(elem, prop, value) {
- var ret;
- // if the prop is a string
- if (isString(prop)) {
- // set the value
- if (defined(value)) {
- elem.setAttribute(prop, value);
- // get the value
- }
- else if (elem && elem.getAttribute) {
- ret = elem.getAttribute(prop);
- // IE7 and below cannot get class through getAttribute (#7850)
- if (!ret && prop === 'class') {
- ret = elem.getAttribute(prop + 'Name');
- }
- }
- // else if prop is defined, it is a hash of key/value pairs
- }
- else {
- objectEach(prop, function (val, key) {
- elem.setAttribute(key, val);
- });
- }
- return ret;
- }
- /**
- * Check if an element is an array, and if not, make it into an array.
- *
- * @function Highcharts.splat
- *
- * @param {*} obj
- * The object to splat.
- *
- * @return {Array}
- * The produced or original array.
- */
- function splat(obj) {
- return isArray(obj) ? obj : [obj];
- }
- /**
- * Set a timeout if the delay is given, otherwise perform the function
- * synchronously.
- *
- * @function Highcharts.syncTimeout
- *
- * @param {Function} fn
- * The function callback.
- *
- * @param {number} delay
- * Delay in milliseconds.
- *
- * @param {*} [context]
- * An optional context to send to the function callback.
- *
- * @return {number}
- * An identifier for the timeout that can later be cleared with
- * Highcharts.clearTimeout. Returns -1 if there is no timeout.
- */
- function syncTimeout(fn, delay, context) {
- if (delay > 0) {
- return setTimeout(fn, delay, context);
- }
- fn.call(0, context);
- return -1;
- }
- /**
- * Internal clear timeout. The function checks that the `id` was not removed
- * (e.g. by `chart.destroy()`). For the details see
- * [issue #7901](https://github.com/highcharts/highcharts/issues/7901).
- *
- * @function Highcharts.clearTimeout
- *
- * @param {number} id
- * Id of a timeout.
- *
- * @return {void}
- */
- function internalClearTimeout(id) {
- if (defined(id)) {
- clearTimeout(id);
- }
- }
- /* eslint-disable valid-jsdoc */
- /**
- * Utility function to extend an object with the members of another.
- *
- * @function Highcharts.extend<T>
- *
- * @param {T|undefined} a
- * The object to be extended.
- *
- * @param {object} b
- * The object to add to the first one.
- *
- * @return {T}
- * Object a, the original object.
- */
- function extend(a, b) {
- /* eslint-enable valid-jsdoc */
- var n;
- if (!a) {
- a = {};
- }
- for (n in b) { // eslint-disable-line guard-for-in
- a[n] = b[n];
- }
- return a;
- }
- /* eslint-disable valid-jsdoc */
- /**
- * Return the first value that is not null or undefined.
- *
- * @function Highcharts.pick<T>
- *
- * @param {...Array<T|null|undefined>} items
- * Variable number of arguments to inspect.
- *
- * @return {T}
- * The value of the first argument that is not null or undefined.
- */
- function pick() {
- var args = arguments;
- var length = args.length;
- for (var i = 0; i < length; i++) {
- var arg = args[i];
- if (typeof arg !== 'undefined' && arg !== null) {
- return arg;
- }
- }
- }
- /**
- * Set CSS on a given element.
- *
- * @function Highcharts.css
- *
- * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} el
- * An HTML DOM element.
- *
- * @param {Highcharts.CSSObject} styles
- * Style object with camel case property names.
- *
- * @return {void}
- */
- function css(el, styles) {
- if (H.isMS && !H.svg) { // #2686
- if (styles && typeof styles.opacity !== 'undefined') {
- styles.filter =
- 'alpha(opacity=' + (styles.opacity * 100) + ')';
- }
- }
- extend(el.style, styles);
- }
- /**
- * Utility function to create an HTML element with attributes and styles.
- *
- * @function Highcharts.createElement
- *
- * @param {string} tag
- * The HTML tag.
- *
- * @param {Highcharts.HTMLAttributes} [attribs]
- * Attributes as an object of key-value pairs.
- *
- * @param {Highcharts.CSSObject} [styles]
- * Styles as an object of key-value pairs.
- *
- * @param {Highcharts.HTMLDOMElement} [parent]
- * The parent HTML object.
- *
- * @param {boolean} [nopad=false]
- * If true, remove all padding, border and margin.
- *
- * @return {Highcharts.HTMLDOMElement}
- * The created DOM element.
- */
- function createElement(tag, attribs, styles, parent, nopad) {
- var el = doc.createElement(tag);
- if (attribs) {
- extend(el, attribs);
- }
- if (nopad) {
- css(el, { padding: '0', border: 'none', margin: '0' });
- }
- if (styles) {
- css(el, styles);
- }
- if (parent) {
- parent.appendChild(el);
- }
- return el;
- }
- // eslint-disable-next-line valid-jsdoc
- /**
- * Extend a prototyped class by new members.
- *
- * @function Highcharts.extendClass<T>
- *
- * @param {Highcharts.Class<T>} parent
- * The parent prototype to inherit.
- *
- * @param {Highcharts.Dictionary<*>} members
- * A collection of prototype members to add or override compared to the
- * parent prototype.
- *
- * @return {Highcharts.Class<T>}
- * A new prototype.
- */
- function extendClass(parent, members) {
- var obj = (function () { });
- obj.prototype = new parent(); // eslint-disable-line new-cap
- extend(obj.prototype, members);
- return obj;
- }
- /**
- * Left-pad a string to a given length by adding a character repetetively.
- *
- * @function Highcharts.pad
- *
- * @param {number} number
- * The input string or number.
- *
- * @param {number} [length]
- * The desired string length.
- *
- * @param {string} [padder=0]
- * The character to pad with.
- *
- * @return {string}
- * The padded string.
- */
- function pad(number, length, padder) {
- return new Array((length || 2) +
- 1 -
- String(number)
- .replace('-', '')
- .length).join(padder || '0') + number;
- }
- /**
- * Return a length based on either the integer value, or a percentage of a base.
- *
- * @function Highcharts.relativeLength
- *
- * @param {Highcharts.RelativeSize} value
- * A percentage string or a number.
- *
- * @param {number} base
- * The full length that represents 100%.
- *
- * @param {number} [offset=0]
- * A pixel offset to apply for percentage values. Used internally in
- * axis positioning.
- *
- * @return {number}
- * The computed length.
- */
- function relativeLength(value, base, offset) {
- return (/%$/).test(value) ?
- (base * parseFloat(value) / 100) + (offset || 0) :
- parseFloat(value);
- }
- /**
- * Wrap a method with extended functionality, preserving the original function.
- *
- * @function Highcharts.wrap
- *
- * @param {*} obj
- * The context object that the method belongs to. In real cases, this is
- * often a prototype.
- *
- * @param {string} method
- * The name of the method to extend.
- *
- * @param {Highcharts.WrapProceedFunction} func
- * A wrapper function callback. This function is called with the same
- * arguments as the original function, except that the original function
- * is unshifted and passed as the first argument.
- */
- function wrap(obj, method, func) {
- var proceed = obj[method];
- obj[method] = function () {
- var args = Array.prototype.slice.call(arguments), outerArgs = arguments, ctx = this, ret;
- ctx.proceed = function () {
- proceed.apply(ctx, arguments.length ? arguments : outerArgs);
- };
- args.unshift(proceed);
- ret = func.apply(this, args);
- ctx.proceed = null;
- return ret;
- };
- }
- /**
- * Format a string according to a subset of the rules of Python's String.format
- * method.
- *
- * @example
- * var s = Highcharts.format(
- * 'The {color} fox was {len:.2f} feet long',
- * { color: 'red', len: Math.PI }
- * );
- * // => The red fox was 3.14 feet long
- *
- * @function Highcharts.format
- *
- * @param {string} str
- * The string to format.
- *
- * @param {Record<string, *>} ctx
- * The context, a collection of key-value pairs where each key is
- * replaced by its value.
- *
- * @param {Highcharts.Chart} [chart]
- * A `Chart` instance used to get numberFormatter and time.
- *
- * @return {string}
- * The formatted string.
- */
- function format(str, ctx, chart) {
- var splitter = '{', isInside = false, segment, valueAndFormat, ret = [], val, index;
- var floatRegex = /f$/;
- var decRegex = /\.([0-9])/;
- var lang = H.defaultOptions.lang;
- var time = chart && chart.time || H.time;
- var numberFormatter = chart && chart.numberFormatter || numberFormat;
- while (str) {
- index = str.indexOf(splitter);
- if (index === -1) {
- break;
- }
- segment = str.slice(0, index);
- if (isInside) { // we're on the closing bracket looking back
- valueAndFormat = segment.split(':');
- val = getNestedProperty(valueAndFormat.shift() || '', ctx);
- // Format the replacement
- if (valueAndFormat.length && typeof val === 'number') {
- segment = valueAndFormat.join(':');
- if (floatRegex.test(segment)) { // float
- var decimals = parseInt((segment.match(decRegex) || ['', '-1'])[1], 10);
- if (val !== null) {
- val = numberFormatter(val, decimals, lang.decimalPoint, segment.indexOf(',') > -1 ? lang.thousandsSep : '');
- }
- }
- else {
- val = time.dateFormat(segment, val);
- }
- }
- // Push the result and advance the cursor
- ret.push(val);
- }
- else {
- ret.push(segment);
- }
- str = str.slice(index + 1); // the rest
- isInside = !isInside; // toggle
- splitter = isInside ? '}' : '{'; // now look for next matching bracket
- }
- ret.push(str);
- return ret.join('');
- }
- /**
- * Get the magnitude of a number.
- *
- * @function Highcharts.getMagnitude
- *
- * @param {number} num
- * The number.
- *
- * @return {number}
- * The magnitude, where 1-9 are magnitude 1, 10-99 magnitude 2 etc.
- */
- function getMagnitude(num) {
- return Math.pow(10, Math.floor(Math.log(num) / Math.LN10));
- }
- /**
- * Take an interval and normalize it to multiples of round numbers.
- *
- * @deprecated
- * @function Highcharts.normalizeTickInterval
- *
- * @param {number} interval
- * The raw, un-rounded interval.
- *
- * @param {Array<*>} [multiples]
- * Allowed multiples.
- *
- * @param {number} [magnitude]
- * The magnitude of the number.
- *
- * @param {boolean} [allowDecimals]
- * Whether to allow decimals.
- *
- * @param {boolean} [hasTickAmount]
- * If it has tickAmount, avoid landing on tick intervals lower than
- * original.
- *
- * @return {number}
- * The normalized interval.
- *
- * @todo
- * Move this function to the Axis prototype. It is here only for historical
- * reasons.
- */
- function normalizeTickInterval(interval, multiples, magnitude, allowDecimals, hasTickAmount) {
- var normalized, i, retInterval = interval;
- // round to a tenfold of 1, 2, 2.5 or 5
- magnitude = pick(magnitude, 1);
- normalized = interval / magnitude;
- // multiples for a linear scale
- if (!multiples) {
- multiples = hasTickAmount ?
- // Finer grained ticks when the tick amount is hard set, including
- // when alignTicks is true on multiple axes (#4580).
- [1, 1.2, 1.5, 2, 2.5, 3, 4, 5, 6, 8, 10] :
- // Else, let ticks fall on rounder numbers
- [1, 2, 2.5, 5, 10];
- // the allowDecimals option
- if (allowDecimals === false) {
- if (magnitude === 1) {
- multiples = multiples.filter(function (num) {
- return num % 1 === 0;
- });
- }
- else if (magnitude <= 0.1) {
- multiples = [1 / magnitude];
- }
- }
- }
- // normalize the interval to the nearest multiple
- for (i = 0; i < multiples.length; i++) {
- retInterval = multiples[i];
- // only allow tick amounts smaller than natural
- if ((hasTickAmount &&
- retInterval * magnitude >= interval) ||
- (!hasTickAmount &&
- (normalized <=
- (multiples[i] +
- (multiples[i + 1] || multiples[i])) / 2))) {
- break;
- }
- }
- // Multiply back to the correct magnitude. Correct floats to appropriate
- // precision (#6085).
- retInterval = correctFloat(retInterval * magnitude, -Math.round(Math.log(0.001) / Math.LN10));
- return retInterval;
- }
- /**
- * Sort an object array and keep the order of equal items. The ECMAScript
- * standard does not specify the behaviour when items are equal.
- *
- * @function Highcharts.stableSort
- *
- * @param {Array<*>} arr
- * The array to sort.
- *
- * @param {Function} sortFunction
- * The function to sort it with, like with regular Array.prototype.sort.
- *
- * @return {void}
- */
- function stableSort(arr, sortFunction) {
- // @todo It seems like Chrome since v70 sorts in a stable way internally,
- // plus all other browsers do it, so over time we may be able to remove this
- // function
- var length = arr.length, sortValue, i;
- // Add index to each item
- for (i = 0; i < length; i++) {
- arr[i].safeI = i; // stable sort index
- }
- arr.sort(function (a, b) {
- sortValue = sortFunction(a, b);
- return sortValue === 0 ? a.safeI - b.safeI : sortValue;
- });
- // Remove index from items
- for (i = 0; i < length; i++) {
- delete arr[i].safeI; // stable sort index
- }
- }
- /**
- * Non-recursive method to find the lowest member of an array. `Math.min` raises
- * a maximum call stack size exceeded error in Chrome when trying to apply more
- * than 150.000 points. This method is slightly slower, but safe.
- *
- * @function Highcharts.arrayMin
- *
- * @param {Array<*>} data
- * An array of numbers.
- *
- * @return {number}
- * The lowest number.
- */
- function arrayMin(data) {
- var i = data.length, min = data[0];
- while (i--) {
- if (data[i] < min) {
- min = data[i];
- }
- }
- return min;
- }
- /**
- * Non-recursive method to find the lowest member of an array. `Math.max` raises
- * a maximum call stack size exceeded error in Chrome when trying to apply more
- * than 150.000 points. This method is slightly slower, but safe.
- *
- * @function Highcharts.arrayMax
- *
- * @param {Array<*>} data
- * An array of numbers.
- *
- * @return {number}
- * The highest number.
- */
- function arrayMax(data) {
- var i = data.length, max = data[0];
- while (i--) {
- if (data[i] > max) {
- max = data[i];
- }
- }
- return max;
- }
- /**
- * Utility method that destroys any SVGElement instances that are properties on
- * the given object. It loops all properties and invokes destroy if there is a
- * destroy method. The property is then delete.
- *
- * @function Highcharts.destroyObjectProperties
- *
- * @param {*} obj
- * The object to destroy properties on.
- *
- * @param {*} [except]
- * Exception, do not destroy this property, only delete it.
- */
- function destroyObjectProperties(obj, except) {
- objectEach(obj, function (val, n) {
- // If the object is non-null and destroy is defined
- if (val && val !== except && val.destroy) {
- // Invoke the destroy
- val.destroy();
- }
- // Delete the property from the object.
- delete obj[n];
- });
- }
- /**
- * Discard a HTML element by moving it to the bin and delete.
- *
- * @function Highcharts.discardElement
- *
- * @param {Highcharts.HTMLDOMElement} element
- * The HTML node to discard.
- */
- function discardElement(element) {
- // create a garbage bin element, not part of the DOM
- if (!garbageBin) {
- garbageBin = createElement('div');
- }
- // move the node and empty bin
- if (element) {
- garbageBin.appendChild(element);
- }
- garbageBin.innerHTML = '';
- }
- var garbageBin;
- /**
- * Fix JS round off float errors.
- *
- * @function Highcharts.correctFloat
- *
- * @param {number} num
- * A float number to fix.
- *
- * @param {number} [prec=14]
- * The precision.
- *
- * @return {number}
- * The corrected float number.
- */
- function correctFloat(num, prec) {
- return parseFloat(num.toPrecision(prec || 14));
- }
- /**
- * The time unit lookup
- *
- * @ignore
- */
- var timeUnits = {
- millisecond: 1,
- second: 1000,
- minute: 60000,
- hour: 3600000,
- day: 24 * 3600000,
- week: 7 * 24 * 3600000,
- month: 28 * 24 * 3600000,
- year: 364 * 24 * 3600000
- };
- /**
- * Format a number and return a string based on input settings.
- *
- * @sample highcharts/members/highcharts-numberformat/
- * Custom number format
- *
- * @function Highcharts.numberFormat
- *
- * @param {number} number
- * The input number to format.
- *
- * @param {number} decimals
- * The amount of decimals. A value of -1 preserves the amount in the
- * input number.
- *
- * @param {string} [decimalPoint]
- * The decimal point, defaults to the one given in the lang options, or
- * a dot.
- *
- * @param {string} [thousandsSep]
- * The thousands separator, defaults to the one given in the lang
- * options, or a space character.
- *
- * @return {string}
- * The formatted number.
- */
- function numberFormat(number, decimals, decimalPoint, thousandsSep) {
- number = +number || 0;
- decimals = +decimals;
- var lang = H.defaultOptions.lang, origDec = (number.toString().split('.')[1] || '').split('e')[0].length, strinteger, thousands, ret, roundedNumber, exponent = number.toString().split('e'), fractionDigits, firstDecimals = decimals;
- if (decimals === -1) {
- // Preserve decimals. Not huge numbers (#3793).
- decimals = Math.min(origDec, 20);
- }
- else if (!isNumber(decimals)) {
- decimals = 2;
- }
- else if (decimals && exponent[1] && exponent[1] < 0) {
- // Expose decimals from exponential notation (#7042)
- fractionDigits = decimals + +exponent[1];
- if (fractionDigits >= 0) {
- // remove too small part of the number while keeping the notation
- exponent[0] = (+exponent[0]).toExponential(fractionDigits)
- .split('e')[0];
- decimals = fractionDigits;
- }
- else {
- // fractionDigits < 0
- exponent[0] = exponent[0].split('.')[0] || 0;
- if (decimals < 20) {
- // use number instead of exponential notation (#7405)
- number = (exponent[0] * Math.pow(10, exponent[1]))
- .toFixed(decimals);
- }
- else {
- // or zero
- number = 0;
- }
- exponent[1] = 0;
- }
- }
- // Add another decimal to avoid rounding errors of float numbers. (#4573)
- // Then use toFixed to handle rounding.
- roundedNumber = (Math.abs(exponent[1] ? exponent[0] : number) +
- Math.pow(10, -Math.max(decimals, origDec) - 1)).toFixed(decimals);
- // A string containing the positive integer component of the number
- strinteger = String(pInt(roundedNumber));
- // Leftover after grouping into thousands. Can be 0, 1 or 2.
- thousands = strinteger.length > 3 ? strinteger.length % 3 : 0;
- // Language
- decimalPoint = pick(decimalPoint, lang.decimalPoint);
- thousandsSep = pick(thousandsSep, lang.thousandsSep);
- // Start building the return
- ret = number < 0 ? '-' : '';
- // Add the leftover after grouping into thousands. For example, in the
- // number 42 000 000, this line adds 42.
- ret += thousands ? strinteger.substr(0, thousands) + thousandsSep : '';
- if (+exponent[1] < 0 && !firstDecimals) {
- ret = '0';
- }
- else {
- // Add the remaining thousands groups, joined by the thousands separator
- ret += strinteger
- .substr(thousands)
- .replace(/(\d{3})(?=\d)/g, '$1' + thousandsSep);
- }
- // Add the decimal point and the decimal component
- if (decimals) {
- // Get the decimal component
- ret += decimalPoint + roundedNumber.slice(-decimals);
- }
- if (exponent[1] && +ret !== 0) {
- ret += 'e' + exponent[1];
- }
- return ret;
- }
- /**
- * Easing definition
- *
- * @private
- * @function Math.easeInOutSine
- *
- * @param {number} pos
- * Current position, ranging from 0 to 1.
- *
- * @return {number}
- * Ease result
- */
- Math.easeInOutSine = function (pos) {
- return -0.5 * (Math.cos(Math.PI * pos) - 1);
- };
- /**
- * Returns the value of a property path on a given object.
- *
- * @private
- * @function getNestedProperty
- *
- * @param {string} path
- * Path to the property, for example `custom.myValue`.
- *
- * @param {unknown} obj
- * Instance containing the property on the specific path.
- *
- * @return {unknown}
- * The unknown property value.
- */
- function getNestedProperty(path, obj) {
- if (!path) {
- return obj;
- }
- var pathElements = path.split('.').reverse();
- var subProperty = obj;
- if (pathElements.length === 1) {
- return subProperty[path];
- }
- var pathElement = pathElements.pop();
- while (typeof pathElement !== 'undefined' &&
- typeof subProperty !== 'undefined' &&
- subProperty !== null) {
- subProperty = subProperty[pathElement];
- pathElement = pathElements.pop();
- }
- return subProperty;
- }
- /**
- * Get the computed CSS value for given element and property, only for numerical
- * properties. For width and height, the dimension of the inner box (excluding
- * padding) is returned. Used for fitting the chart within the container.
- *
- * @function Highcharts.getStyle
- *
- * @param {Highcharts.HTMLDOMElement} el
- * An HTML element.
- *
- * @param {string} prop
- * The property name.
- *
- * @param {boolean} [toInt=true]
- * Parse to integer.
- *
- * @return {number|string}
- * The numeric value.
- */
- function getStyle(el, prop, toInt) {
- var style;
- // For width and height, return the actual inner pixel size (#4913)
- if (prop === 'width') {
- var offsetWidth = Math.min(el.offsetWidth, el.scrollWidth);
- // In flex boxes, we need to use getBoundingClientRect and floor it,
- // because scrollWidth doesn't support subpixel precision (#6427) ...
- var boundingClientRectWidth = el.getBoundingClientRect &&
- el.getBoundingClientRect().width;
- // ...unless if the containing div or its parents are transform-scaled
- // down, in which case the boundingClientRect can't be used as it is
- // also scaled down (#9871, #10498).
- if (boundingClientRectWidth < offsetWidth &&
- boundingClientRectWidth >= offsetWidth - 1) {
- offsetWidth = Math.floor(boundingClientRectWidth);
- }
- return Math.max(0, // #8377
- (offsetWidth -
- H.getStyle(el, 'padding-left') -
- H.getStyle(el, 'padding-right')));
- }
- if (prop === 'height') {
- return Math.max(0, // #8377
- Math.min(el.offsetHeight, el.scrollHeight) -
- H.getStyle(el, 'padding-top') -
- H.getStyle(el, 'padding-bottom'));
- }
- if (!win.getComputedStyle) {
- // SVG not supported, forgot to load oldie.js?
- error(27, true);
- }
- // Otherwise, get the computed style
- style = win.getComputedStyle(el, undefined); // eslint-disable-line no-undefined
- if (style) {
- style = style.getPropertyValue(prop);
- if (pick(toInt, prop !== 'opacity')) {
- style = pInt(style);
- }
- }
- return style;
- }
- /**
- * Search for an item in an array.
- *
- * @function Highcharts.inArray
- *
- * @deprecated
- *
- * @param {*} item
- * The item to search for.
- *
- * @param {Array<*>} arr
- * The array or node collection to search in.
- *
- * @param {number} [fromIndex=0]
- * The index to start searching from.
- *
- * @return {number}
- * The index within the array, or -1 if not found.
- */
- function inArray(item, arr, fromIndex) {
- error(32, false, void 0, { 'Highcharts.inArray': 'use Array.indexOf' });
- return arr.indexOf(item, fromIndex);
- }
- /* eslint-disable valid-jsdoc */
- /**
- * Return the value of the first element in the array that satisfies the
- * provided testing function.
- *
- * @function Highcharts.find<T>
- *
- * @param {Array<T>} arr
- * The array to test.
- *
- * @param {Function} callback
- * The callback function. The function receives the item as the first
- * argument. Return `true` if this item satisfies the condition.
- *
- * @return {T|undefined}
- * The value of the element.
- */
- var find = Array.prototype.find ?
- /* eslint-enable valid-jsdoc */
- function (arr, callback) {
- return arr.find(callback);
- } :
- // Legacy implementation. PhantomJS, IE <= 11 etc. #7223.
- function (arr, callback) {
- var i, length = arr.length;
- for (i = 0; i < length; i++) {
- if (callback(arr[i], i)) { // eslint-disable-line callback-return
- return arr[i];
- }
- }
- };
- /**
- * Returns an array of a given object's own properties.
- *
- * @function Highcharts.keys
- * @deprecated
- *
- * @param {*} obj
- * The object of which the properties are to be returned.
- *
- * @return {Array<string>}
- * An array of strings that represents all the properties.
- */
- function keys(obj) {
- error(32, false, void 0, { 'Highcharts.keys': 'use Object.keys' });
- return Object.keys(obj);
- }
- /**
- * Get the element's offset position, corrected for `overflow: auto`.
- *
- * @function Highcharts.offset
- *
- * @param {global.Element} el
- * The DOM element.
- *
- * @return {Highcharts.OffsetObject}
- * An object containing `left` and `top` properties for the position in
- * the page.
- */
- function offset(el) {
- var docElem = doc.documentElement, box = (el.parentElement || el.parentNode) ?
- el.getBoundingClientRect() :
- { top: 0, left: 0, width: 0, height: 0 };
- return {
- top: box.top + (win.pageYOffset || docElem.scrollTop) -
- (docElem.clientTop || 0),
- left: box.left + (win.pageXOffset || docElem.scrollLeft) -
- (docElem.clientLeft || 0),
- width: box.width,
- height: box.height
- };
- }
- /* eslint-disable valid-jsdoc */
- /**
- * Iterate over object key pairs in an object.
- *
- * @function Highcharts.objectEach<T>
- *
- * @param {*} obj
- * The object to iterate over.
- *
- * @param {Highcharts.ObjectEachCallbackFunction<T>} fn
- * The iterator callback. It passes three arguments:
- * * value - The property value.
- * * key - The property key.
- * * obj - The object that objectEach is being applied to.
- *
- * @param {T} [ctx]
- * The context.
- *
- * @return {void}
- */
- function objectEach(obj, fn, ctx) {
- /* eslint-enable valid-jsdoc */
- for (var key in obj) {
- if (Object.hasOwnProperty.call(obj, key)) {
- fn.call(ctx || obj[key], obj[key], key, obj);
- }
- }
- }
- /**
- * Iterate over an array.
- *
- * @deprecated
- * @function Highcharts.each
- *
- * @param {Array<*>} arr
- * The array to iterate over.
- *
- * @param {Function} fn
- * The iterator callback. It passes three arguments:
- * - `item`: The array item.
- * - `index`: The item's index in the array.
- * - `arr`: The array that each is being applied to.
- *
- * @param {*} [ctx]
- * The context.
- *
- * @return {void}
- */
- /**
- * Filter an array by a callback.
- *
- * @deprecated
- * @function Highcharts.grep
- *
- * @param {Array<*>} arr
- * The array to filter.
- *
- * @param {Function} callback
- * The callback function. The function receives the item as the first
- * argument. Return `true` if the item is to be preserved.
- *
- * @return {Array<*>}
- * A new, filtered array.
- */
- /**
- * Map an array by a callback.
- *
- * @deprecated
- * @function Highcharts.map
- *
- * @param {Array<*>} arr
- * The array to map.
- *
- * @param {Function} fn
- * The callback function. Return the new value for the new array.
- *
- * @return {Array<*>}
- * A new array item with modified items.
- */
- /**
- * Reduce an array to a single value.
- *
- * @deprecated
- * @function Highcharts.reduce
- *
- * @param {Array<*>} arr
- * The array to reduce.
- *
- * @param {Function} fn
- * The callback function. Return the reduced value. Receives 4
- * arguments: Accumulated/reduced value, current value, current array
- * index, and the array.
- *
- * @param {*} initialValue
- * The initial value of the accumulator.
- *
- * @return {*}
- * The reduced value.
- */
- /**
- * Test whether at least one element in the array passes the test implemented by
- * the provided function.
- *
- * @deprecated
- * @function Highcharts.some
- *
- * @param {Array<*>} arr
- * The array to test
- *
- * @param {Function} fn
- * The function to run on each item. Return truty to pass the test.
- * Receives arguments `currentValue`, `index` and `array`.
- *
- * @param {*} ctx
- * The context.
- *
- * @return {boolean}
- */
- objectEach({
- map: 'map',
- each: 'forEach',
- grep: 'filter',
- reduce: 'reduce',
- some: 'some'
- }, function (val, key) {
- H[key] = function (arr) {
- var _a;
- error(32, false, void 0, (_a = {}, _a["Highcharts." + key] = "use Array." + val, _a));
- return Array.prototype[val].apply(arr, [].slice.call(arguments, 1));
- };
- });
- /* eslint-disable valid-jsdoc */
- /**
- * Add an event listener.
- *
- * @function Highcharts.addEvent<T>
- *
- * @param {Highcharts.Class<T>|T} el
- * The element or object to add a listener to. It can be a
- * {@link HTMLDOMElement}, an {@link SVGElement} or any other object.
- *
- * @param {string} type
- * The event type.
- *
- * @param {Highcharts.EventCallbackFunction<T>|Function} fn
- * The function callback to execute when the event is fired.
- *
- * @param {Highcharts.EventOptionsObject} [options]
- * Options for adding the event.
- *
- * @return {Function}
- * A callback function to remove the added event.
- */
- function addEvent(el, type, fn, options) {
- /* eslint-enable valid-jsdoc */
- if (options === void 0) { options = {}; }
- // Add hcEvents to either the prototype (in case we're running addEvent on a
- // class) or the instance. If hasOwnProperty('hcEvents') is false, it is
- // inherited down the prototype chain, in which case we need to set the
- // property on this instance (which may itself be a prototype).
- var owner = typeof el === 'function' && el.prototype || el;
- if (!Object.hasOwnProperty.call(owner, 'hcEvents')) {
- owner.hcEvents = {};
- }
- var events = owner.hcEvents;
- // Allow click events added to points, otherwise they will be prevented by
- // the TouchPointer.pinch function after a pinch zoom operation (#7091).
- if (H.Point && // without H a dependency loop occurs
- el instanceof H.Point &&
- el.series &&
- el.series.chart) {
- el.series.chart.runTrackerClick = true;
- }
- // Handle DOM events
- // If the browser supports passive events, add it to improve performance
- // on touch events (#11353).
- var addEventListener = (el.addEventListener || H.addEventListenerPolyfill);
- if (addEventListener) {
- addEventListener.call(el, type, fn, H.supportsPassiveEvents ? {
- passive: options.passive === void 0 ?
- type.indexOf('touch') !== -1 : options.passive,
- capture: false
- } : false);
- }
- if (!events[type]) {
- events[type] = [];
- }
- var eventObject = {
- fn: fn,
- order: typeof options.order === 'number' ? options.order : Infinity
- };
- events[type].push(eventObject);
- // Order the calls
- events[type].sort(function (a, b) { return a.order - b.order; });
- // Return a function that can be called to remove this event.
- return function () {
- removeEvent(el, type, fn);
- };
- }
- /* eslint-disable valid-jsdoc */
- /**
- * Remove an event that was added with {@link Highcharts#addEvent}.
- *
- * @function Highcharts.removeEvent<T>
- *
- * @param {Highcharts.Class<T>|T} el
- * The element to remove events on.
- *
- * @param {string} [type]
- * The type of events to remove. If undefined, all events are removed
- * from the element.
- *
- * @param {Highcharts.EventCallbackFunction<T>} [fn]
- * The specific callback to remove. If undefined, all events that match
- * the element and optionally the type are removed.
- *
- * @return {void}
- */
- function removeEvent(el, type, fn) {
- /* eslint-enable valid-jsdoc */
- /**
- * @private
- * @param {string} type - event type
- * @param {Highcharts.EventCallbackFunction<T>} fn - callback
- * @return {void}
- */
- function removeOneEvent(type, fn) {
- var removeEventListener = (el.removeEventListener || H.removeEventListenerPolyfill);
- if (removeEventListener) {
- removeEventListener.call(el, type, fn, false);
- }
- }
- /**
- * @private
- * @param {any} eventCollection - collection
- * @return {void}
- */
- function removeAllEvents(eventCollection) {
- var types, len;
- if (!el.nodeName) {
- return; // break on non-DOM events
- }
- if (type) {
- types = {};
- types[type] = true;
- }
- else {
- types = eventCollection;
- }
- objectEach(types, function (_val, n) {
- if (eventCollection[n]) {
- len = eventCollection[n].length;
- while (len--) {
- removeOneEvent(n, eventCollection[n][len].fn);
- }
- }
- });
- }
- var owner = typeof el === 'function' && el.prototype || el;
- if (Object.hasOwnProperty.call(owner, 'hcEvents')) {
- var events = owner.hcEvents;
- if (type) {
- var typeEvents = (events[type] || []);
- if (fn) {
- events[type] = typeEvents.filter(function (obj) {
- return fn !== obj.fn;
- });
- removeOneEvent(type, fn);
- }
- else {
- removeAllEvents(events);
- events[type] = [];
- }
- }
- else {
- removeAllEvents(events);
- delete owner.hcEvents;
- }
- }
- }
- /* eslint-disable valid-jsdoc */
- /**
- * Fire an event that was registered with {@link Highcharts#addEvent}.
- *
- * @function Highcharts.fireEvent<T>
- *
- * @param {T} el
- * The object to fire the event on. It can be a {@link HTMLDOMElement},
- * an {@link SVGElement} or any other object.
- *
- * @param {string} type
- * The type of event.
- *
- * @param {Highcharts.Dictionary<*>|Event} [eventArguments]
- * Custom event arguments that are passed on as an argument to the event
- * handler.
- *
- * @param {Highcharts.EventCallbackFunction<T>|Function} [defaultFunction]
- * The default function to execute if the other listeners haven't
- * returned false.
- *
- * @return {void}
- */
- function fireEvent(el, type, eventArguments, defaultFunction) {
- /* eslint-enable valid-jsdoc */
- var e, i;
- eventArguments = eventArguments || {};
- if (doc.createEvent &&
- (el.dispatchEvent || el.fireEvent)) {
- e = doc.createEvent('Events');
- e.initEvent(type, true, true);
- extend(e, eventArguments);
- if (el.dispatchEvent) {
- el.dispatchEvent(e);
- }
- else {
- el.fireEvent(type, e);
- }
- }
- else if (el.hcEvents) {
- if (!eventArguments.target) {
- // We're running a custom event
- extend(eventArguments, {
- // Attach a simple preventDefault function to skip
- // default handler if called. The built-in
- // defaultPrevented property is not overwritable (#5112)
- preventDefault: function () {
- eventArguments.defaultPrevented = true;
- },
- // Setting target to native events fails with clicking
- // the zoom-out button in Chrome.
- target: el,
- // If the type is not set, we're running a custom event
- // (#2297). If it is set, we're running a browser event,
- // and setting it will cause en error in IE8 (#2465).
- type: type
- });
- }
- var events = [];
- var object = el;
- var multilevel = false;
- // Recurse up the inheritance chain and collect hcEvents set as own
- // objects on the prototypes.
- while (object.hcEvents) {
- if (Object.hasOwnProperty.call(object, 'hcEvents') &&
- object.hcEvents[type]) {
- if (events.length) {
- multilevel = true;
- }
- events.unshift.apply(events, object.hcEvents[type]);
- }
- object = Object.getPrototypeOf(object);
- }
- // For performance reasons, only sort the event handlers in case we are
- // dealing with multiple levels in the prototype chain. Otherwise, the
- // events are already sorted in the addEvent function.
- if (multilevel) {
- // Order the calls
- events.sort(function (a, b) { return a.order - b.order; });
- }
- // Call the collected event handlers
- events.forEach(function (obj) {
- // If the event handler returns false, prevent the default handler
- // from executing
- if (obj.fn.call(el, eventArguments) === false) {
- eventArguments.preventDefault();
- }
- });
- }
- // Run the default if not prevented
- if (defaultFunction && !eventArguments.defaultPrevented) {
- defaultFunction.call(el, eventArguments);
- }
- }
- var serialMode;
- /**
- * Get a unique key for using in internal element id's and pointers. The key is
- * composed of a random hash specific to this Highcharts instance, and a
- * counter.
- *
- * @example
- * var id = uniqueKey(); // => 'highcharts-x45f6hp-0'
- *
- * @function Highcharts.uniqueKey
- *
- * @return {string}
- * A unique key.
- */
- var uniqueKey = (function () {
- var hash = Math.random().toString(36).substring(2, 9) + '-';
- var id = 0;
- return function () {
- return 'highcharts-' + (serialMode ? '' : hash) + id++;
- };
- }());
- /**
- * Activates a serial mode for element IDs provided by
- * {@link Highcharts.uniqueKey}. This mode can be used in automated tests, where
- * a simple comparison of two rendered SVG graphics is needed.
- *
- * **Note:** This is only for testing purposes and will break functionality in
- * webpages with multiple charts.
- *
- * @example
- * if (
- * process &&
- * process.env.NODE_ENV === 'development'
- * ) {
- * Highcharts.useSerialIds(true);
- * }
- *
- * @function Highcharts.useSerialIds
- *
- * @param {boolean} [mode]
- * Changes the state of serial mode.
- *
- * @return {boolean|undefined}
- * State of the serial mode.
- */
- function useSerialIds(mode) {
- return (serialMode = pick(mode, serialMode));
- }
- function isFunction(obj) {
- return typeof obj === 'function';
- }
- /**
- * Get the updated default options. Until 3.0.7, merely exposing defaultOptions
- * for outside modules wasn't enough because the setOptions method created a new
- * object.
- *
- * @function Highcharts.getOptions
- *
- * @return {Highcharts.Options}
- */
- var getOptions = H.getOptions = function () {
- return H.defaultOptions;
- };
- /**
- * Merge the default options with custom options and return the new options
- * structure. Commonly used for defining reusable templates.
- *
- * @sample highcharts/global/useutc-false Setting a global option
- * @sample highcharts/members/setoptions Applying a global theme
- *
- * @function Highcharts.setOptions
- *
- * @param {Highcharts.Options} options
- * The new custom chart options.
- *
- * @return {Highcharts.Options}
- * Updated options.
- */
- var setOptions = H.setOptions = function (options) {
- // Copy in the default options
- H.defaultOptions = merge(true, H.defaultOptions, options);
- // Update the time object
- if (options.time || options.global) {
- H.time.update(merge(H.defaultOptions.global, H.defaultOptions.time, options.global, options.time));
- }
- return H.defaultOptions;
- };
- // Register Highcharts as a plugin in jQuery
- if (win.jQuery) {
- /**
- * Highcharts-extended JQuery.
- *
- * @external JQuery
- */
- /**
- * Helper function to return the chart of the current JQuery selector
- * element.
- *
- * @function external:JQuery#highcharts
- *
- * @return {Highcharts.Chart}
- * The chart that is linked to the JQuery selector element.
- */ /**
- * Factory function to create a chart in the current JQuery selector
- * element.
- *
- * @function external:JQuery#highcharts
- *
- * @param {'Chart'|'Map'|'StockChart'|string} [className]
- * Name of the factory class in the Highcharts namespace.
- *
- * @param {Highcharts.Options} [options]
- * The chart options structure.
- *
- * @param {Highcharts.ChartCallbackFunction} [callback]
- * Function to run when the chart has loaded and and all external
- * images are loaded. Defining a
- * [chart.events.load](https://api.highcharts.com/highcharts/chart.events.load)
- * handler is equivalent.
- *
- * @return {JQuery}
- * The current JQuery selector.
- */
- win.jQuery.fn.highcharts = function () {
- var args = [].slice.call(arguments);
- if (this[0]) { // this[0] is the renderTo div
- // Create the chart
- if (args[0]) {
- new H[ // eslint-disable-line computed-property-spacing, no-new
- // Constructor defaults to Chart
- isString(args[0]) ? args.shift() : 'Chart'](this[0], args[0], args[1]);
- return this;
- }
- // When called without parameters or with the return argument,
- // return an existing chart
- return charts[attr(this[0], 'data-highcharts-chart')];
- }
- };
- }
- // TODO use named exports when supported.
- var utilitiesModule = {
- addEvent: addEvent,
- arrayMax: arrayMax,
- arrayMin: arrayMin,
- attr: attr,
- clamp: clamp,
- cleanRecursively: cleanRecursively,
- clearTimeout: internalClearTimeout,
- correctFloat: correctFloat,
- createElement: createElement,
- css: css,
- defined: defined,
- destroyObjectProperties: destroyObjectProperties,
- discardElement: discardElement,
- erase: erase,
- error: error,
- extend: extend,
- extendClass: extendClass,
- find: find,
- fireEvent: fireEvent,
- format: format,
- getMagnitude: getMagnitude,
- getNestedProperty: getNestedProperty,
- getOptions: getOptions,
- getStyle: getStyle,
- inArray: inArray,
- isArray: isArray,
- isClass: isClass,
- isDOMElement: isDOMElement,
- isFunction: isFunction,
- isNumber: isNumber,
- isObject: isObject,
- isString: isString,
- keys: keys,
- merge: merge,
- normalizeTickInterval: normalizeTickInterval,
- numberFormat: numberFormat,
- objectEach: objectEach,
- offset: offset,
- pad: pad,
- pick: pick,
- pInt: pInt,
- relativeLength: relativeLength,
- removeEvent: removeEvent,
- setOptions: setOptions,
- splat: splat,
- stableSort: stableSort,
- syncTimeout: syncTimeout,
- timeUnits: timeUnits,
- uniqueKey: uniqueKey,
- useSerialIds: useSerialIds,
- wrap: wrap
- };
- export default utilitiesModule;
|