highcharts
Version:
JavaScript charting framework
161 lines (160 loc) • 6.21 kB
JavaScript
/* *
*
* Solid angular gauge module
*
* (c) 2010-2025 Torstein Honsi
*
* License: www.highcharts.com/license
*
* !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
*
* */
;
import BorderRadius from '../../Extensions/BorderRadius.js';
import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
const { gauge: GaugeSeries, pie: PieSeries } = SeriesRegistry.seriesTypes;
import SolidGaugeAxis from '../../Core/Axis/SolidGaugeAxis.js';
import SolidGaugeSeriesDefaults from './SolidGaugeSeriesDefaults.js';
import U from '../../Core/Utilities.js';
const { clamp, extend, isNumber, merge, pick, pInt } = U;
/* *
*
* Class
*
* */
/**
* SolidGauge series type.
*
* @private
* @class
* @name Highcharts.seriesTypes.solidgauge
*
* @augments Highcarts.Series
*/
class SolidGaugeSeries extends GaugeSeries {
/* *
*
* Functions
*
* */
// Extend the translate function to extend the Y axis with the necessary
// decoration (#5895).
translate() {
const axis = this.yAxis;
SolidGaugeAxis.init(axis);
// Prepare data classes
if (!axis.dataClasses && axis.options.dataClasses) {
axis.initDataClasses(axis.options);
}
axis.initStops();
// Generate points and inherit data label position
GaugeSeries.prototype.translate.call(this);
}
// Draw the points where each point is one needle.
drawPoints() {
const series = this, yAxis = series.yAxis, center = yAxis.center, options = series.options, renderer = series.chart.renderer, overshoot = options.overshoot, rounded = options.rounded && options.borderRadius === void 0, overshootVal = isNumber(overshoot) ?
overshoot / 180 * Math.PI :
0;
let thresholdAngleRad;
// Handle the threshold option
if (isNumber(options.threshold)) {
thresholdAngleRad = yAxis.startAngleRad + yAxis.translate(options.threshold, void 0, void 0, void 0, true);
}
this.thresholdAngleRad = pick(thresholdAngleRad, yAxis.startAngleRad);
for (const point of series.points) {
// #10630 null point should not be draw
if (!point.isNull) { // Condition like in pie chart
const radius = ((pInt(pick(point.options.radius, options.radius, 100 // %
)) * center[2]) / 200), innerRadius = ((pInt(pick(point.options.innerRadius, options.innerRadius, 60 // %
)) * center[2]) / 200), axisMinAngle = Math.min(yAxis.startAngleRad, yAxis.endAngleRad), axisMaxAngle = Math.max(yAxis.startAngleRad, yAxis.endAngleRad);
let graphic = point.graphic, rotation = (yAxis.startAngleRad +
yAxis.translate(point.y, void 0, void 0, void 0, true)), shapeArgs, d, toColor = yAxis.toColor(point.y, point);
if (toColor === 'none') { // #3708
toColor = point.color || series.color || 'none';
}
if (toColor !== 'none') {
point.color = toColor;
}
// Handle overshoot and clipping to axis max/min
rotation = clamp(rotation, axisMinAngle - overshootVal, axisMaxAngle + overshootVal);
// Handle the wrap option
if (options.wrap === false) {
rotation = clamp(rotation, axisMinAngle, axisMaxAngle);
}
const angleOfRounding = rounded ?
((radius - innerRadius) / 2) / radius :
0, start = Math.min(rotation, series.thresholdAngleRad) -
angleOfRounding;
let end = Math.max(rotation, series.thresholdAngleRad) +
angleOfRounding;
if (end - start > 2 * Math.PI) {
end = start + 2 * Math.PI;
}
let borderRadius = rounded ? '50%' : 0;
if (options.borderRadius) {
borderRadius = BorderRadius.optionsToObject(options.borderRadius).radius;
}
point.shapeArgs = shapeArgs = {
x: center[0],
y: center[1],
r: radius,
innerR: innerRadius,
start,
end,
borderRadius
};
point.startR = radius; // For PieSeries.animate
if (graphic) {
d = shapeArgs.d;
graphic.animate(extend({ fill: toColor }, shapeArgs));
if (d) {
shapeArgs.d = d; // Animate alters it
}
}
else {
point.graphic = graphic = renderer.arc(shapeArgs)
.attr({
fill: toColor,
'sweep-flag': 0
})
.add(series.group);
}
if (!series.chart.styledMode) {
if (options.linecap !== 'square') {
graphic.attr({
'stroke-linecap': 'round',
'stroke-linejoin': 'round'
});
}
graphic.attr({
stroke: options.borderColor || 'none',
'stroke-width': options.borderWidth || 0
});
}
if (graphic) {
graphic.addClass(point.getClassName(), true);
}
}
}
}
// Extend the pie slice animation by animating from start angle and up.
animate(init) {
if (!init) {
this.startAngleRad = this.thresholdAngleRad;
PieSeries.prototype.animate.call(this, init);
}
}
}
/* *
*
* Static Properties
*
* */
SolidGaugeSeries.defaultOptions = merge(GaugeSeries.defaultOptions, SolidGaugeSeriesDefaults);
SeriesRegistry.registerSeriesType('solidgauge', SolidGaugeSeries);
/* *
*
* Default Export
*
* */
export default SolidGaugeSeries;