UNPKG

highcharts

Version:
1,397 lines (1,225 loc) 412 kB
/** * @license Highcharts JS v7.1.0 (2019-04-01) * * (c) 2009-2018 Torstein Honsi * * License: www.highcharts.com/license */ 'use strict'; (function (factory) { if (typeof module === 'object' && module.exports) { factory['default'] = factory; module.exports = factory; } else if (typeof define === 'function' && define.amd) { define('highcharts/highcharts-more', ['highcharts'], function (Highcharts) { factory(Highcharts); factory.Highcharts = Highcharts; return factory; }); } else { factory(typeof Highcharts !== 'undefined' ? Highcharts : undefined); } }(function (Highcharts) { var _modules = Highcharts ? Highcharts._modules : {}; function _registerModule(obj, path, args, fn) { if (!obj.hasOwnProperty(path)) { obj[path] = fn.apply(null, args); } } _registerModule(_modules, 'parts-more/Pane.js', [_modules['parts/Globals.js']], function (H) { /* * * (c) 2010-2019 Torstein Honsi * * License: www.highcharts.com/license */ /** * @typedef {"arc"|"circle"|"solid"} Highcharts.PaneBackgroundShapeValue */ var CenteredSeriesMixin = H.CenteredSeriesMixin, extend = H.extend, merge = H.merge, splat = H.splat; /** * The Pane object allows options that are common to a set of X and Y axes. * * In the future, this can be extended to basic Highcharts and Highstock. * * @private * @class * @name Highcharts.Pane * * @param {Highcharts.PaneOptions} options * * @param {Highcharts.Chart} chart */ function Pane(options, chart) { this.init(options, chart); } // Extend the Pane prototype extend(Pane.prototype, { coll: 'pane', // Member of chart.pane /** * Initialize the Pane object * * @private * @function Highcharts.Pane#init * * @param {Highcharts.PaneOptions} options * * @param {Highcharts.Chart} chart */ init: function (options, chart) { this.chart = chart; this.background = []; chart.pane.push(this); this.setOptions(options); }, /** * @private * @function Highcharts.Pane#setOptions * * @param {Highcharts.PaneOptions} options */ setOptions: function (options) { // Set options. Angular charts have a default background (#3318) this.options = options = merge( this.defaultOptions, this.chart.angular ? { background: {} } : undefined, options ); }, /** * Render the pane with its backgrounds. * * @private * @function Highcharts.Pane#render */ render: function () { var options = this.options, backgroundOption = this.options.background, renderer = this.chart.renderer, len, i; if (!this.group) { this.group = renderer.g('pane-group') .attr({ zIndex: options.zIndex || 0 }) .add(); } this.updateCenter(); // Render the backgrounds if (backgroundOption) { backgroundOption = splat(backgroundOption); len = Math.max( backgroundOption.length, this.background.length || 0 ); for (i = 0; i < len; i++) { // #6641 - if axis exists, chart is circular and apply // background if (backgroundOption[i] && this.axis) { this.renderBackground( merge( this.defaultBackgroundOptions, backgroundOption[i] ), i ); } else if (this.background[i]) { this.background[i] = this.background[i].destroy(); this.background.splice(i, 1); } } } }, /** * Render an individual pane background. * * @private * @function Highcharts.Pane#renderBackground * * @param {Highcharts.PaneBackgroundOptions} backgroundOptions * Background options * * @param {number} i * The index of the background in this.backgrounds */ renderBackground: function (backgroundOptions, i) { var method = 'animate', attribs = { 'class': 'highcharts-pane ' + (backgroundOptions.className || '') }; if (!this.chart.styledMode) { extend(attribs, { 'fill': backgroundOptions.backgroundColor, 'stroke': backgroundOptions.borderColor, 'stroke-width': backgroundOptions.borderWidth }); } if (!this.background[i]) { this.background[i] = this.chart.renderer.path() .add(this.group); method = 'attr'; } this.background[i][method]({ 'd': this.axis.getPlotBandPath( backgroundOptions.from, backgroundOptions.to, backgroundOptions ) }).attr(attribs); }, /** * The pane serves as a container for axes and backgrounds for circular * gauges and polar charts. * * @since 2.3.0 * @product highcharts * @optionparent pane */ defaultOptions: { /** * The end angle of the polar X axis or gauge value axis, given in * degrees where 0 is north. Defaults to [startAngle](#pane.startAngle) * + 360. * * @sample {highcharts} highcharts/demo/gauge-vu-meter/ * VU-meter with custom start and end angle * * @type {number} * @since 2.3.0 * @product highcharts * @apioption pane.endAngle */ /** * The center of a polar chart or angular gauge, given as an array * of [x, y] positions. Positions can be given as integers that * transform to pixels, or as percentages of the plot area size. * * @sample {highcharts} highcharts/demo/gauge-vu-meter/ * Two gauges with different center * * @type {Array<string|number>} * @default ["50%", "50%"] * @since 2.3.0 * @product highcharts */ center: ['50%', '50%'], /** * The size of the pane, either as a number defining pixels, or a * percentage defining a percentage of the plot are. * * @sample {highcharts} highcharts/demo/gauge-vu-meter/ * Smaller size * * @type {number|string} * @product highcharts */ size: '85%', /** * The start angle of the polar X axis or gauge axis, given in degrees * where 0 is north. Defaults to 0. * * @sample {highcharts} highcharts/demo/gauge-vu-meter/ * VU-meter with custom start and end angle * * @since 2.3.0 * @product highcharts */ startAngle: 0 }, /** * An array of background items for the pane. * * @sample {highcharts} highcharts/demo/gauge-speedometer/ * Speedometer gauge with multiple backgrounds * * @type {Array<*>} * @optionparent pane.background */ defaultBackgroundOptions: { /** * The class name for this background. * * @sample {highcharts} highcharts/css/pane/ * Panes styled by CSS * @sample {highstock} highcharts/css/pane/ * Panes styled by CSS * @sample {highmaps} highcharts/css/pane/ * Panes styled by CSS * * @type {string} * @default highcharts-pane * @since 5.0.0 * @apioption pane.background.className */ /** * The shape of the pane background. When `solid`, the background * is circular. When `arc`, the background extends only from the min * to the max of the value axis. * * @type {Highcharts.PaneBackgroundShapeValue} * @since 2.3.0 * @product highcharts */ shape: 'circle', /** * The pixel border width of the pane background. * * @since 2.3.0 * @product highcharts */ borderWidth: 1, /** * The pane background border color. * * @type {Highcharts.ColorString} * @since 2.3.0 * @product highcharts */ borderColor: '#cccccc', /** * The background color or gradient for the pane. * * @type {Highcharts.GradientColorObject} * @default { linearGradient: { x1: 0, y1: 0, x2: 0, y2: 1 }, stops: [[0, #ffffff], [1, #e6e6e6]] } * @since 2.3.0 * @product highcharts */ backgroundColor: { /** @ignore-option */ linearGradient: { x1: 0, y1: 0, x2: 0, y2: 1 }, /** @ignore-option */ stops: [ [0, '#ffffff'], [1, '#e6e6e6'] ] }, /** @ignore-option */ from: -Number.MAX_VALUE, // corrected to axis min /** * The inner radius of the pane background. Can be either numeric * (pixels) or a percentage string. * * @type {number|string} * @since 2.3.0 * @product highcharts */ innerRadius: 0, /** @ignore-option */ to: Number.MAX_VALUE, // corrected to axis max /** * The outer radius of the circular pane background. Can be either * numeric (pixels) or a percentage string. * * @type {number|string} * @since 2.3.0 * @product highcharts */ outerRadius: '105%' }, /** * Gets the center for the pane and its axis. * * @private * @function Highcharts.Pane#updateCenter * * @param {Highcharts.RadialAxis} axis */ updateCenter: function (axis) { this.center = (axis || this.axis || {}).center = CenteredSeriesMixin.getCenter.call(this); }, /** * Destroy the pane item * * @ignore * @private * @function Highcharts.Pane#destroy * / destroy: function () { H.erase(this.chart.pane, this); this.background.forEach(function (background) { background.destroy(); }); this.background.length = 0; this.group = this.group.destroy(); }, */ /** * Update the pane item with new options * * @private * @function Highcharts.Pane#update * * @param {Highcharts.PaneOptions} options * New pane options * * @param {boolean} redraw */ update: function (options, redraw) { merge(true, this.options, options); merge(true, this.chart.options.pane, options); // #9917 this.setOptions(this.options); this.render(); this.chart.axes.forEach(function (axis) { if (axis.pane === this) { axis.pane = null; axis.update({}, redraw); } }, this); } }); H.Pane = Pane; }); _registerModule(_modules, 'parts-more/RadialAxis.js', [_modules['parts/Globals.js']], function (H) { /* * * (c) 2010-2019 Torstein Honsi * * License: www.highcharts.com/license */ var addEvent = H.addEvent, Axis = H.Axis, extend = H.extend, merge = H.merge, noop = H.noop, pick = H.pick, pInt = H.pInt, Tick = H.Tick, wrap = H.wrap, correctFloat = H.correctFloat, hiddenAxisMixin, // @todo Extract this to a new file radialAxisMixin, // @todo Extract this to a new file axisProto = Axis.prototype, tickProto = Tick.prototype; // Augmented methods for the x axis in order to hide it completely, used for // the X axis in gauges hiddenAxisMixin = { getOffset: noop, redraw: function () { this.isDirty = false; // prevent setting Y axis dirty }, render: function () { this.isDirty = false; // prevent setting Y axis dirty }, setScale: noop, setCategories: noop, setTitle: noop }; // Augmented methods for the value axis radialAxisMixin = { // The default options extend defaultYAxisOptions defaultRadialGaugeOptions: { labels: { align: 'center', x: 0, y: null // auto }, minorGridLineWidth: 0, minorTickInterval: 'auto', minorTickLength: 10, minorTickPosition: 'inside', minorTickWidth: 1, tickLength: 10, tickPosition: 'inside', tickWidth: 2, title: { rotation: 0 }, zIndex: 2 // behind dials, points in the series group }, // Circular axis around the perimeter of a polar chart defaultRadialXOptions: { gridLineWidth: 1, // spokes labels: { align: null, // auto distance: 15, x: 0, y: null, // auto style: { textOverflow: 'none' // wrap lines by default (#7248) } }, maxPadding: 0, minPadding: 0, showLastLabel: false, tickLength: 0 }, // Radial axis, like a spoke in a polar chart defaultRadialYOptions: { gridLineInterpolation: 'circle', labels: { align: 'right', x: -3, y: -2 }, showLastLabel: false, title: { x: 4, text: null, rotation: 90 } }, // Merge and set options setOptions: function (userOptions) { var options = this.options = merge( this.defaultOptions, this.defaultRadialOptions, userOptions ); // Make sure the plotBands array is instanciated for each Axis // (#2649) if (!options.plotBands) { options.plotBands = []; } H.fireEvent(this, 'afterSetOptions'); }, // Wrap the getOffset method to return zero offset for title or labels // in a radial axis getOffset: function () { // Call the Axis prototype method (the method we're in now is on the // instance) axisProto.getOffset.call(this); // Title or label offsets are not counted this.chart.axisOffset[this.side] = 0; }, // Get the path for the axis line. This method is also referenced in the // getPlotLinePath method. getLinePath: function (lineWidth, radius) { var center = this.center, end, chart = this.chart, r = pick(radius, center[2] / 2 - this.offset), path; if (this.isCircular || radius !== undefined) { path = this.chart.renderer.symbols.arc( this.left + center[0], this.top + center[1], r, r, { start: this.startAngleRad, end: this.endAngleRad, open: true, innerR: 0 } ); // Bounds used to position the plotLine label next to the line // (#7117) path.xBounds = [this.left + center[0]]; path.yBounds = [this.top + center[1] - r]; } else { end = this.postTranslate(this.angleRad, r); path = [ 'M', center[0] + chart.plotLeft, center[1] + chart.plotTop, 'L', end.x, end.y ]; } return path; }, /* * * Override setAxisTranslation by setting the translation to the * difference in rotation. This allows the translate method to return * angle for any given value. */ setAxisTranslation: function () { // Call uber method axisProto.setAxisTranslation.call(this); // Set transA and minPixelPadding if (this.center) { // it's not defined the first time if (this.isCircular) { this.transA = (this.endAngleRad - this.startAngleRad) / ((this.max - this.min) || 1); } else { this.transA = ( (this.center[2] / 2) / ((this.max - this.min) || 1) ); } if (this.isXAxis) { this.minPixelPadding = this.transA * this.minPointOffset; } else { // This is a workaround for regression #2593, but categories // still don't position correctly. this.minPixelPadding = 0; } } }, /* * * In case of auto connect, add one closestPointRange to the max value * right before tickPositions are computed, so that ticks will extend * passed the real max. */ beforeSetTickPositions: function () { // If autoConnect is true, polygonal grid lines are connected, and // one closestPointRange is added to the X axis to prevent the last // point from overlapping the first. this.autoConnect = ( this.isCircular && pick(this.userMax, this.options.max) === undefined && correctFloat(this.endAngleRad - this.startAngleRad) === correctFloat(2 * Math.PI) ); if (this.autoConnect) { this.max += ( (this.categories && 1) || this.pointRange || this.closestPointRange || 0 ); // #1197, #2260 } }, /* * * Override the setAxisSize method to use the arc's circumference as * length. This allows tickPixelInterval to apply to pixel lengths along * the perimeter */ setAxisSize: function () { axisProto.setAxisSize.call(this); if (this.isRadial) { // Set the center array this.pane.updateCenter(this); // The sector is used in Axis.translate to compute the // translation of reversed axis points (#2570) if (this.isCircular) { this.sector = this.endAngleRad - this.startAngleRad; } // Axis len is used to lay out the ticks this.len = this.width = this.height = this.center[2] * pick(this.sector, 1) / 2; } }, /* * * Returns the x, y coordinate of a point given by a value and a pixel * distance from center */ getPosition: function (value, length) { return this.postTranslate( this.isCircular ? this.translate(value) : this.angleRad, // #2848 pick( this.isCircular ? length : this.translate(value), this.center[2] / 2 ) - this.offset ); }, /* * * Translate from intermediate plotX (angle), plotY (axis.len - radius) * to final chart coordinates. */ postTranslate: function (angle, radius) { var chart = this.chart, center = this.center; angle = this.startAngleRad + angle; return { x: chart.plotLeft + center[0] + Math.cos(angle) * radius, y: chart.plotTop + center[1] + Math.sin(angle) * radius }; }, /* * * Find the path for plot bands along the radial axis */ getPlotBandPath: function (from, to, options) { var center = this.center, startAngleRad = this.startAngleRad, fullRadius = center[2] / 2, radii = [ pick(options.outerRadius, '100%'), options.innerRadius, pick(options.thickness, 10) ], offset = Math.min(this.offset, 0), percentRegex = /%$/, start, end, angle, xOnPerimeter, open, isCircular = this.isCircular, // X axis in a polar chart ret; // Polygonal plot bands if (this.options.gridLineInterpolation === 'polygon') { ret = this.getPlotLinePath(from).concat( this.getPlotLinePath(to, true) ); // Circular grid bands } else { // Keep within bounds from = Math.max(from, this.min); to = Math.min(to, this.max); // Plot bands on Y axis (radial axis) - inner and outer radius // depend on to and from if (!isCircular) { radii[0] = this.translate(from); radii[1] = this.translate(to); } // Convert percentages to pixel values radii = radii.map(function (radius) { if (percentRegex.test(radius)) { radius = (pInt(radius, 10) * fullRadius) / 100; } return radius; }); // Handle full circle if (options.shape === 'circle' || !isCircular) { start = -Math.PI / 2; end = Math.PI * 1.5; open = true; } else { start = startAngleRad + this.translate(from); end = startAngleRad + this.translate(to); } radii[0] -= offset; // #5283 radii[2] -= offset; // #5283 ret = this.chart.renderer.symbols.arc( this.left + center[0], this.top + center[1], radii[0], radii[0], { // Math is for reversed yAxis (#3606) start: Math.min(start, end), end: Math.max(start, end), innerR: pick(radii[1], radii[0] - radii[2]), open: open } ); // Provide positioning boxes for the label (#6406) if (isCircular) { angle = (end + start) / 2; xOnPerimeter = ( this.left + center[0] + (center[2] / 2) * Math.cos(angle) ); ret.xBounds = angle > -Math.PI / 2 && angle < Math.PI / 2 ? // Right hemisphere [xOnPerimeter, this.chart.plotWidth] : // Left hemisphere [0, xOnPerimeter]; ret.yBounds = [ this.top + center[1] + (center[2] / 2) * Math.sin(angle) ]; // Shift up or down to get the label clear of the perimeter ret.yBounds[0] += ( (angle > -Math.PI && angle < 0) || (angle > Math.PI) ) ? -10 : 10; } } return ret; }, /* * * Find the path for plot lines perpendicular to the radial axis. */ getPlotLinePath: function (value, reverse) { var axis = this, center = axis.center, chart = axis.chart, end = axis.getPosition(value), xAxis, xy, tickPositions, ret; // Spokes if (axis.isCircular) { ret = [ 'M', center[0] + chart.plotLeft, center[1] + chart.plotTop, 'L', end.x, end.y ]; // Concentric circles } else if (axis.options.gridLineInterpolation === 'circle') { value = axis.translate(value); // a value of 0 is in the center, so it won't be visible, // but draw it anyway for update and animation (#2366) ret = axis.getLinePath(0, value); // Concentric polygons } else { // Find the X axis in the same pane chart.xAxis.forEach(function (a) { if (a.pane === axis.pane) { xAxis = a; } }); ret = []; value = axis.translate(value); tickPositions = xAxis.tickPositions; if (xAxis.autoConnect) { tickPositions = tickPositions.concat([tickPositions[0]]); } // Reverse the positions for concatenation of polygonal plot // bands if (reverse) { tickPositions = [].concat(tickPositions).reverse(); } tickPositions.forEach(function (pos, i) { xy = xAxis.getPosition(pos, value); ret.push(i ? 'L' : 'M', xy.x, xy.y); }); } return ret; }, /* * * Find the position for the axis title, by default inside the gauge */ getTitlePosition: function () { var center = this.center, chart = this.chart, titleOptions = this.options.title; return { x: chart.plotLeft + center[0] + (titleOptions.x || 0), y: ( chart.plotTop + center[1] - ( { high: 0.5, middle: 0.25, low: 0 }[titleOptions.align] * center[2] ) + (titleOptions.y || 0) ) }; } }; // Actions before axis init. addEvent(Axis, 'init', function (e) { var axis = this, chart = this.chart, angular = chart.angular, polar = chart.polar, isX = this.isXAxis, isHidden = angular && isX, isCircular, chartOptions = chart.options, paneIndex = e.userOptions.pane || 0, pane = this.pane = chart.pane && chart.pane[paneIndex]; // Before prototype.init if (angular) { extend(this, isHidden ? hiddenAxisMixin : radialAxisMixin); isCircular = !isX; if (isCircular) { this.defaultRadialOptions = this.defaultRadialGaugeOptions; } } else if (polar) { extend(this, radialAxisMixin); isCircular = isX; this.defaultRadialOptions = isX ? this.defaultRadialXOptions : merge(this.defaultYAxisOptions, this.defaultRadialYOptions); } // Disable certain features on angular and polar axes if (angular || polar) { this.isRadial = true; chart.inverted = false; chartOptions.chart.zoomType = null; // Prevent overlapping axis labels (#9761) chart.labelCollectors.push(function () { if ( axis.isRadial && axis.tickPositions && // undocumented option for now, but working axis.options.labels.allowOverlap !== true ) { return axis.tickPositions .map(function (pos) { return axis.ticks[pos] && axis.ticks[pos].label; }) .filter(function (label) { return Boolean(label); }); } }); } else { this.isRadial = false; } // A pointer back to this axis to borrow geometry if (pane && isCircular) { pane.axis = this; } this.isCircular = isCircular; }); addEvent(Axis, 'afterInit', function () { var chart = this.chart, options = this.options, isHidden = chart.angular && this.isXAxis, pane = this.pane, paneOptions = pane && pane.options; if (!isHidden && pane && (chart.angular || chart.polar)) { // Start and end angle options are // given in degrees relative to top, while internal computations are // in radians relative to right (like SVG). // Y axis in polar charts this.angleRad = (options.angle || 0) * Math.PI / 180; // Gauges this.startAngleRad = (paneOptions.startAngle - 90) * Math.PI / 180; this.endAngleRad = ( pick(paneOptions.endAngle, paneOptions.startAngle + 360) - 90 ) * Math.PI / 180; // Gauges this.offset = options.offset || 0; } }); // Wrap auto label align to avoid setting axis-wide rotation on radial axes // (#4920) addEvent(Axis, 'autoLabelAlign', function (e) { if (this.isRadial) { e.align = undefined; e.preventDefault(); } }); // Add special cases within the Tick class' methods for radial axes. addEvent(Tick, 'afterGetPosition', function (e) { if (this.axis.getPosition) { extend(e.pos, this.axis.getPosition(this.pos)); } }); // Find the center position of the label based on the distance option. addEvent(Tick, 'afterGetLabelPosition', function (e) { var axis = this.axis, label = this.label, labelOptions = axis.options.labels, optionsY = labelOptions.y, ret, centerSlot = 20, // 20 degrees to each side at the top and bottom align = labelOptions.align, angle = ( (axis.translate(this.pos) + axis.startAngleRad + Math.PI / 2) / Math.PI * 180 ) % 360; if (axis.isRadial) { // Both X and Y axes in a polar chart ret = axis.getPosition(this.pos, (axis.center[2] / 2) + pick(labelOptions.distance, -25)); // Automatically rotated if (labelOptions.rotation === 'auto') { label.attr({ rotation: angle }); // Vertically centered } else if (optionsY === null) { optionsY = ( axis.chart.renderer .fontMetrics(label.styles && label.styles.fontSize).b - label.getBBox().height / 2 ); } // Automatic alignment if (align === null) { if (axis.isCircular) { // Y axis if ( this.label.getBBox().width > axis.len * axis.tickInterval / (axis.max - axis.min) ) { // #3506 centerSlot = 0; } if (angle > centerSlot && angle < 180 - centerSlot) { align = 'left'; // right hemisphere } else if ( angle > 180 + centerSlot && angle < 360 - centerSlot ) { align = 'right'; // left hemisphere } else { align = 'center'; // top or bottom } } else { align = 'center'; } label.attr({ align: align }); } e.pos.x = ret.x + labelOptions.x; e.pos.y = ret.y + optionsY; } }); // Wrap the getMarkPath function to return the path of the radial marker wrap(tickProto, 'getMarkPath', function ( proceed, x, y, tickLength, tickWidth, horiz, renderer ) { var axis = this.axis, endPoint, ret; if (axis.isRadial) { endPoint = axis.getPosition( this.pos, axis.center[2] / 2 + tickLength ); ret = [ 'M', x, y, 'L', endPoint.x, endPoint.y ]; } else { ret = proceed.call( this, x, y, tickLength, tickWidth, horiz, renderer ); } return ret; }); }); _registerModule(_modules, 'parts-more/AreaRangeSeries.js', [_modules['parts/Globals.js']], function (H) { /* * * * (c) 2010-2019 Torstein Honsi * * License: www.highcharts.com/license * * */ /** * Extended data labels for range series types. Range series data labels use no * `x` and `y` options. Instead, they have `xLow`, `xHigh`, `yLow` and `yHigh` * options to allow the higher and lower data label sets individually. * * @interface Highcharts.PlotAreaRangeDataLabelsOptionsObject * @extends Highcharts.DataLabelsOptionsObject * @since 2.3.0 * @product highcharts highstock *//** * X offset of the lower data labels relative to the point value. * * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/arearange-datalabels/|Highcharts-Demo:} * Data labels on range series * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/arearange-datalabels/|Highcharts-Demo:} * Data labels on range series * * @name Highcharts.PlotAreaRangeDataLabelsOptionsObject#xLow * @type {number|undefined} * @default 0 * @since 2.3.0 * @product highcharts highstock *//** * X offset of the higher data labels relative to the point value. * * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/arearange-datalabels/|Highcharts-Demo:} * Data labels on range series * * @name Highcharts.PlotAreaRangeDataLabelsOptionsObject#xHigh * @type {number|undefined} * @default 0 * @since 2.3.0 * @product highcharts highstock *//** * Y offset of the lower data labels relative to the point value. * * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/arearange-datalabels/|Highcharts-Demo:} * Data labels on range series * * @name Highcharts.PlotAreaRangeDataLabelsOptionsObject#yLow * @type {number|undefined} * @default 0 * @since 2.3.0 * @product highcharts highstock *//** * Y offset of the higher data labels relative to the point value. * * @see {@link https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/plotoptions/arearange-datalabels/|Highcharts-Demo:} * Data labels on range series * * @name Highcharts.PlotAreaRangeDataLabelsOptionsObject#yHigh * @type {number|undefined} * @default 0 * @since 2.3.0 * @product highcharts highstock */ var noop = H.noop, pick = H.pick, extend = H.extend, isArray = H.isArray, defined = H.defined, Series = H.Series, seriesType = H.seriesType, seriesTypes = H.seriesTypes, seriesProto = Series.prototype, pointProto = H.Point.prototype; /** * The area range series is a carteseian series with higher and lower values for * each point along an X axis, where the area between the values is shaded. * Requires `highcharts-more.js`. * * @sample {highcharts} highcharts/demo/arearange/ * Area range chart * @sample {highstock} stock/demo/arearange/ * Area range chart * * @extends plotOptions.area * @product highcharts highstock * @excluding stack, stacking * @optionparent plotOptions.arearange */ seriesType('arearange', 'area', { /** * Whether to apply a drop shadow to the graph line. Since 2.3 the shadow * can be an object configuration containing `color`, `offsetX`, `offsetY`, * `opacity` and `width`. * * @type {boolean|Highcharts.ShadowOptionsObject} * @product highcharts * @apioption plotOptions.arearange.shadow */ /** * Pixel width of the arearange graph line. * * @since 2.3.0 * * @private */ lineWidth: 1, threshold: null, tooltip: { pointFormat: '<span style="color:{series.color}">\u25CF</span> ' + '{series.name}: <b>{point.low}</b> - <b>{point.high}</b><br/>' }, /** * Whether the whole area or just the line should respond to mouseover * tooltips and other mouse or touch events. * * @since 2.3.0 * * @private */ trackByArea: true, /** * @type {Highcharts.DataLabelsOptionsObject|Highcharts.PlotAreaRangeDataLabelsOptionsObject} * * @private */ dataLabels: { /** @ignore-option */ align: null, /** @ignore-option */ verticalAlign: null, /** @ignore-option */ xLow: 0, /** @ignore-option */ xHigh: 0, /** @ignore-option */ yLow: 0, /** @ignore-option */ yHigh: 0 } // Prototype members }, { pointArrayMap: ['low', 'high'], toYData: function (point) { return [point.low, point.high]; }, pointValKey: 'low', deferTranslatePolar: true, // Translate a point's plotHigh from the internal angle and radius measures // to true plotHigh coordinates. This is an addition of the toXY method // found in Polar.js, because it runs too early for arearanges to be // considered (#3419). highToXY: function (point) { // Find the polar plotX and plotY var chart = this.chart, xy = this.xAxis.postTranslate( point.rectPlotX, this.yAxis.len - point.plotHigh ); point.plotHighX = xy.x - chart.plotLeft; point.plotHigh = xy.y - chart.plotTop; point.plotLowX = point.plotX; }, // Translate data points from raw values x and y to plotX and plotY. translate: function () { var series = this, yAxis = series.yAxis, hasModifyValue = !!series.modifyValue; seriesTypes.area.prototype.translate.apply(series); // Set plotLow and plotHigh series.points.forEach(function (point) { var low = point.low, high = point.high, plotY = point.plotY; if (high === null || low === null) { point.isNull = true; point.plotY = null; } else { point.plotLow = plotY; point.plotHigh = yAxis.translate( hasModifyValue ? series.modifyValue(high, point) : high, 0, 1, 0, 1 ); if (hasModifyValue) { point.yBottom = point.plotHigh; } } }); // Postprocess plotHigh if (this.chart.polar) { this.points.forEach(function (point) { series.highToXY(point); point.tooltipPos = [ (point.plotHighX + point.plotLowX) / 2, (point.plotHigh + point.plotLow) / 2 ]; }); } }, // Extend the line series' getSegmentPath method by applying the segment // path to both lower and higher values of the range. getGraphPath: function (points) { var highPoints = [], highAreaPoints = [], i, getGraphPath = seriesTypes.area.prototype.getGraphPath, point, pointShim, linePath, lowerPath, options = this.options, connectEnds = this.chart.polar && options.connectEnds !== false, connectNulls = options.connectNulls, step = options.step, higherPath, higherAreaPath; points = points || this.points; i = points.length; // Create the top line and the top part of the area fill. The area fill // compensates for null points by drawing down to the lower graph, // moving across the null gap and starting again at the lower graph. i = points.length; while (i--) { point = points[i]; if ( !point.isNull && !connectEnds && !connectNulls && (!points[i + 1] || points[i + 1].isNull) ) { highAreaPoints.push({ plotX: point.plotX, plotY: point.plotY, doCurve: false // #5186, gaps in areasplinerange fill }); } pointShim = { polarPlotY: point.polarPlot