/** * @license Highcharts JS v6.1.0 (2018-04-13) * Annotations module * * (c) 2009-2017 Torstein Honsi * * License: www.highcharts.com/license */ 'use strict'; (function (factory) { if (typeof module === 'object' && module.exports) { module.exports = factory; } else { factory(Highcharts); } }(function (Highcharts) { (function (H) { /** * (c) 2009-2017 Highsoft, Black Label * * License: www.highcharts.com/license */ var merge = H.merge, addEvent = H.addEvent, extend = H.extend, each = H.each, isString = H.isString, isNumber = H.isNumber, defined = H.defined, isObject = H.isObject, inArray = H.inArray, erase = H.erase, find = H.find, format = H.format, pick = H.pick, objectEach = H.objectEach, uniqueKey = H.uniqueKey, doc = H.doc, splat = H.splat, destroyObjectProperties = H.destroyObjectProperties, grep = H.grep, tooltipPrototype = H.Tooltip.prototype, seriesPrototype = H.Series.prototype, chartPrototype = H.Chart.prototype; /* *************************************************************************** * * MARKER SECTION * Contains objects and functions for adding a marker element to a path element * **************************************************************************** */ /** * Options for configuring markers for annotations. * * An example of the arrow marker: *

		 * {
		 *   arrow: {
		 *     id: 'arrow',
		 *     tagName: 'marker',
		 *     refY: 5,
		 *     refX: 5,
		 *     markerWidth: 10,
		 *     markerHeight: 10,
		 *     children: [{
		 *       tagName: 'path',
		 *       attrs: {
		 *         d: 'M 0 0 L 10 5 L 0 10 Z',
		 *         strokeWidth: 0
		 *       }
		 *     }]
		 *   }
		 * }
		 *

* @type {Object} * @sample highcharts/annotations/custom-markers/ * Define a custom marker for annotations * @sample highcharts/css/annotations-markers/ * Define markers in a styled mode * @since 6.0.0 * @apioption defs */ var defaultMarkers = { arrow: { tagName: 'marker', render: false, id: 'arrow', refY: 5, refX: 5, markerWidth: 10, markerHeight: 10, children: [{ tagName: 'path', d: 'M 0 0 L 10 5 L 0 10 Z', // triangle (used as an arrow) strokeWidth: 0 }] } }; var MarkerMixin = { markerSetter: function (markerType) { return function (value) { this.attr(markerType, 'url(#' + value + ')'); }; } }; extend(MarkerMixin, { markerEndSetter: MarkerMixin.markerSetter('marker-end'), markerStartSetter: MarkerMixin.markerSetter('marker-start') }); // In a styled mode definition is implemented H.SVGRenderer.prototype.definition = function (def) { var ren = this; function recurse(config, parent) { var ret; each(splat(config), function (item) { var node = ren.createElement(item.tagName), attr = {}; // Set attributes objectEach(item, function (val, key) { if ( key !== 'tagName' && key !== 'children' && key !== 'textContent' ) { attr[key] = val; } }); node.attr(attr); // Add to the tree node.add(parent || ren.defs); // Add text content if (item.textContent) { node.element.appendChild( doc.createTextNode(item.textContent) ); } // Recurse recurse(item.children || [], node); ret = node; }); // Return last node added (on top level it's the only one) return ret; } return recurse(def); }; H.SVGRenderer.prototype.addMarker = function (id, markerOptions) { var options = { id: id }; var attrs = { stroke: markerOptions.color || 'none', fill: markerOptions.color || 'rgba(0, 0, 0, 0.75)' }; options.children = H.map(markerOptions.children, function (child) { return merge(attrs, child); }); var marker = this.definition(merge({ markerWidth: 20, markerHeight: 20, refX: 0, refY: 0, orient: 'auto' }, markerOptions, options)); marker.id = id; return marker; }; /* *************************************************************************** * * MOCK POINT * **************************************************************************** */ /** * A mock point configuration. * * @typedef {Object} MockPointOptions * @property {Number} x - x value for the point in xAxis scale or pixels * @property {Number} y - y value for the point in yAxis scale or pixels * @property {String|Number} [xAxis] - xAxis index or id * @property {String|Number} [yAxis] - yAxis index or id */ /** * A trimmed point object which imitates {@link Highchart.Point} class. * It is created when there is a need of pointing to some chart's position * using axis values or pixel values * * @class MockPoint * @memberOf Highcharts * @private * * @param {Highcharts.Chart} - the chart object * @param {MockPointOptions} - the options object */ var MockPoint = H.MockPoint = function (chart, options) { this.mock = true; this.series = { visible: true, chart: chart, getPlotBox: seriesPrototype.getPlotBox }; // this.plotX // this.plotY /* Those might not exist if a specific axis was not found/defined */ // this.x? // this.y? this.init(chart, options); }; /** * A factory function for creating a mock point object * * @function #mockPoint * @memberOf Highcharts * * @param {MockPointOptions} mockPointOptions * @return {MockPoint} a mock point */ var mockPoint = H.mockPoint = function (chart, mockPointOptions) { return new MockPoint(chart, mockPointOptions); }; MockPoint.prototype = { /** * Initialisation of the mock point * * @function init * @memberOf Highcharts.MockPoint# * * @param {Highcharts.Chart} chart - a chart object to which the mock point * is attached * @param {MockPointOptions} options - a config for the mock point */ init: function (chart, options) { var xAxisId = options.xAxis, xAxis = defined(xAxisId) ? chart.xAxis[xAxisId] || chart.get(xAxisId) : null, yAxisId = options.yAxis, yAxis = defined(yAxisId) ? chart.yAxis[yAxisId] || chart.get(yAxisId) : null; if (xAxis) { this.x = options.x; this.series.xAxis = xAxis; } else { this.plotX = options.x; } if (yAxis) { this.y = options.y; this.series.yAxis = yAxis; } else { this.plotY = options.y; } }, /** * Update of the point's coordinates (plotX/plotY) * * @function translate * @memberOf Highcharts.MockPoint# * * @return {undefined} */ translate: function () { var series = this.series, xAxis = series.xAxis, yAxis = series.yAxis; if (xAxis) { this.plotX = xAxis.toPixels(this.x, true); } if (yAxis) { this.plotY = yAxis.toPixels(this.y, true); } this.isInside = this.isInsidePane(); }, /** * Returns a box to which an item can be aligned to * * @function #alignToBox * @memberOf Highcharts.MockPoint# * * @param {Boolean} [forceTranslate=false] - whether to update the point's * coordinates * @return {Array.} A quadruple of numbers which denotes x, y, * width and height of the box **/ alignToBox: function (forceTranslate) { if (forceTranslate) { this.translate(); } var x = this.plotX, y = this.plotY, temp; if (this.series.chart.inverted) { temp = x; x = y; y = temp; } return [x, y, 0, 0]; }, /** * Returns a label config object - * the same as Highcharts.Point.prototype.getLabelConfig * * @function getLabelConfig * @memberOf Highcharts.MockPoint# * * @return {Object} labelConfig - label config object * @return {Number|undefined} labelConfig.x * X value translated to x axis scale * @return {Number|undefined} labelConfig.y * Y value translated to y axis scale * @return {MockPoint} labelConfig.point * The instance of the point */ getLabelConfig: function () { return { x: this.x, y: this.y, point: this }; }, isInsidePane: function () { var plotX = this.plotX, plotY = this.plotY, xAxis = this.series.xAxis, yAxis = this.series.yAxis, isInside = true; if (xAxis) { isInside = defined(plotX) && plotX >= 0 && plotX <= xAxis.len; } if (yAxis) { isInside = isInside && defined(plotY) && plotY >= 0 && plotY <= yAxis.len; } return isInside; } }; /* *************************************************************************** * * ANNOTATION * **************************************************************************** */ H.defaultOptions.annotations = []; /** * An annotation class which serves as a container for items like labels or * shapes. Created items are positioned on the chart either by linking them to * existing points or created mock points * * @class Annotation * @memberOf Highcharts * * @param {Chart} - the chart object * @param {AnnotationOptions} - the options object */ var Annotation = H.Annotation = function (chart, userOptions) { /** * The chart that the annotation belongs to. * * @name chart * @memberOf Highcharts.Annotation# * @type {Chart} */ this.chart = chart; /** * The array of labels which belong to the annotation. * * @name labels * @memberOf Highcharts.Annotation# * @type {Array} */ this.labels = []; /** * The array of shapes which belong to the annotation. * * @name shapes * @memberOf Highcharts.Annotation# * @type {Array} */ this.shapes = []; /** * The options for the annotations. It containers user defined options * merged with the default options. * * @name options * @memberOf Highcharts.Annotation# * @type {AnnotationOptions} */ this.options = merge(this.defaultOptions, userOptions); /** * The callback that reports to the overlapping-labels module which * labels it should account for. * * @name labelCollector * @memberOf Highcharts.Annotation# * @type {Function} * @private */ /** * The group element of the annotation. * * @name group * @memberOf Highcharts.Annotation# * @type {Highcharts.SVGElement} * @private */ /** * The group element of the annotation's shapes. * * @name shapesGroup * @memberOf Highcharts.Annotation# * @type {Highcharts.SVGElement} * @private */ /** * The group element of the annotation's labels. * * @name labelsGroup * @memberOf Highcharts.Annotation# * @type {Highcharts.SVGElement} * @private */ this.init(chart, userOptions); }; Annotation.prototype = /** @lends Highcharts.Annotation# */ { /** * Shapes which do not have background - the object is used for proper * setting of the contrast color * * @type {Array.} * @private */ shapesWithoutBackground: ['connector'], /** * A map object which allows to map options attributes to element * attributes. * * @type {Object} * @private */ attrsMap: { backgroundColor: 'fill', borderColor: 'stroke', borderWidth: 'stroke-width', dashStyle: 'dashstyle', strokeWidth: 'stroke-width', stroke: 'stroke', fill: 'fill', zIndex: 'zIndex', width: 'width', height: 'height', borderRadius: 'r', r: 'r', padding: 'padding' }, /** * Options for configuring annotations, for example labels, arrows or * shapes. Annotations can be tied to points, axis coordinates or chart * pixel coordinates. * * @private * @type {Array