/* *
|
*
|
* (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;
|
});
|
