/* * * * (c) 2010-2019 Torstein Honsi * * License: www.highcharts.com/license * * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!! * * */ 'use strict'; var _Globals = require('../parts/Globals.js'); var _Globals2 = _interopRequireDefault(_Globals); var _Utilities = require('../parts/Utilities.js'); var _Utilities2 = _interopRequireDefault(_Utilities); require('../parts/Axis.js'); require('../parts/Tick.js'); require('./Pane.js'); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } var pInt = _Utilities2.default.pInt; var addEvent = _Globals2.default.addEvent, Axis = _Globals2.default.Axis, extend = _Globals2.default.extend, merge = _Globals2.default.merge, noop = _Globals2.default.noop, pick = _Globals2.default.pick, Tick = _Globals2.default.Tick, wrap = _Globals2.default.wrap, correctFloat = _Globals2.default.correctFloat, // @todo Extract this to a new file: hiddenAxisMixin, // @todo Extract this to a new file radialAxisMixin, 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 redraw() { this.isDirty = false; // prevent setting Y axis dirty }, render: function render() { 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, labels: { align: null, distance: 15, x: 0, y: null, 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 } }, /* eslint-disable valid-jsdoc */ /** * Merge and set options. * @private */ setOptions: function setOptions(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 = []; } _Globals2.default.fireEvent(this, 'afterSetOptions'); }, /** * Wrap the getOffset method to return zero offset for title or labels in a * radial axis. * @private */ getOffset: function getOffset() { // 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. * @private */ getLinePath: function getLinePath(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. * @private */ setAxisTranslation: function setAxisTranslation() { // 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. * @private */ beforeSetTickPositions: function beforeSetTickPositions() { // 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. * @private */ setAxisSize: function setAxisSize() { 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 * @private */ getPosition: function getPosition(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. * @private */ postTranslate: function postTranslate(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. * @private */ getPlotBandPath: function getPlotBandPath(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({ value: from }).concat(this.getPlotLinePath({ value: to, reverse: 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 getPlotLinePath(options) { var axis = this, center = axis.center, chart = axis.chart, value = options.value, reverse = options.reverse, 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 getTitlePosition() { 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) }; } /* eslint-enable valid-jsdoc */ }; /* eslint-disable no-invalid-this */ // 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, labelBBox = label.getBBox(), 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, correctAngle = Math.round(angle), labelDir = 'end', // Direction of the label 'start' or 'end' reducedAngle1 = correctAngle < 0 ? correctAngle + 360 : correctAngle, reducedAngle2 = reducedAngle1, translateY = 0, translateX = 0, labelYPosCorrection = labelOptions.y === null ? -labelBBox.height * 0.3 : 0; if (axis.isRadial) { // Both X and Y axes in a polar chart ret = axis.getPosition(this.pos, axis.center[2] / 2 + _Globals2.default.relativeLength(pick(labelOptions.distance, -25), axis.center[2] / 2, -axis.center[2] / 2)); // 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 - labelBBox.height / 2; } // Automatic alignment if (align === null) { if (axis.isCircular) { // Y axis if (labelBBox.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 }); } // Auto alignment for solid-gauges with two labels (#10635) if (align === 'auto' && axis.tickPositions.length === 2 && axis.isCircular) { // Angles reduced to 0 - 90 or 180 - 270 if (reducedAngle1 > 90 && reducedAngle1 < 180) { reducedAngle1 = 180 - reducedAngle1; } else if (reducedAngle1 > 270 && reducedAngle1 <= 360) { reducedAngle1 = 540 - reducedAngle1; } // Angles reduced to 0 - 180 if (reducedAngle2 > 180 && reducedAngle2 <= 360) { reducedAngle2 = 360 - reducedAngle2; } if (axis.pane.options.startAngle === correctAngle || axis.pane.options.startAngle === correctAngle + 360 || axis.pane.options.startAngle === correctAngle - 360) { labelDir = 'start'; } if (correctAngle >= -90 && correctAngle <= 90 || correctAngle >= -360 && correctAngle <= -270 || correctAngle >= 270 && correctAngle <= 360) { align = labelDir === 'start' ? 'right' : 'left'; } else { align = labelDir === 'start' ? 'left' : 'right'; } // For angles beetwen (90 + n * 180) +- 20 if (reducedAngle2 > 70 && reducedAngle2 < 110) { align = 'center'; } // auto Y translation if (reducedAngle1 < 15 || reducedAngle1 >= 180 && reducedAngle1 < 195) { translateY = labelBBox.height * 0.3; } else if (reducedAngle1 >= 15 && reducedAngle1 <= 35) { translateY = labelDir === 'start' ? 0 : labelBBox.height * 0.75; } else if (reducedAngle1 >= 195 && reducedAngle1 <= 215) { translateY = labelDir === 'start' ? labelBBox.height * 0.75 : 0; } else if (reducedAngle1 > 35 && reducedAngle1 <= 90) { translateY = labelDir === 'start' ? -labelBBox.height * 0.25 : labelBBox.height; } else if (reducedAngle1 > 215 && reducedAngle1 <= 270) { translateY = labelDir === 'start' ? labelBBox.height : -labelBBox.height * 0.25; } // auto X translation if (reducedAngle2 < 15) { translateX = labelDir === 'start' ? -labelBBox.height * 0.15 : labelBBox.height * 0.15; } else if (reducedAngle2 > 165 && reducedAngle2 <= 180) { translateX = labelDir === 'start' ? labelBBox.height * 0.15 : -labelBBox.height * 0.15; } label.attr({ align: align }); label.translate(translateX, translateY + labelYPosCorrection); } 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; });