devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
306 lines (301 loc) • 12.8 kB
JavaScript
/**
* DevExtreme (esm/viz/gauges/circular_gauge.js)
* Version: 24.2.6
* Build date: Mon Mar 17 2025
*
* Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
const _isFinite = isFinite;
import registerComponent from "../../core/component_registrator";
import {
clone
} from "../../core/utils/object";
import {
extend
} from "../../core/utils/extend";
import {
each
} from "../../core/utils/iterator";
import {
BaseGauge
} from "./base_gauge";
import {
dxGauge,
createIndicatorCreator
} from "./common";
import {
normalizeAngle,
getCosAndSin
} from "../core/utils";
import {
plugins as centerTemplatePlugins
} from "../core/center_template";
const _normalizeAngle = normalizeAngle;
const _getCosAndSin = getCosAndSin;
import * as circularIndicators from "./circular_indicators";
import CircularRangeContainer from "./circular_range_container";
const _abs = Math.abs;
const _max = Math.max;
const _min = Math.min;
const _round = Math.round;
const _each = each;
const PI = Math.PI;
function getSides(startAngle, endAngle) {
const startCosSin = _getCosAndSin(startAngle);
const endCosSin = _getCosAndSin(endAngle);
const startCos = startCosSin.cos;
const startSin = startCosSin.sin;
const endCos = endCosSin.cos;
const endSin = endCosSin.sin;
return {
left: startSin <= 0 && endSin >= 0 || startSin <= 0 && endSin <= 0 && startCos <= endCos || startSin >= 0 && endSin >= 0 && startCos >= endCos ? -1 : _min(startCos, endCos, 0),
right: startSin >= 0 && endSin <= 0 || startSin >= 0 && endSin >= 0 && startCos >= endCos || startSin <= 0 && endSin <= 0 && startCos <= endCos ? 1 : _max(startCos, endCos, 0),
up: startCos <= 0 && endCos >= 0 || startCos <= 0 && endCos <= 0 && startSin >= endSin || startCos >= 0 && endCos >= 0 && startSin <= endSin ? -1 : -_max(startSin, endSin, 0),
down: startCos >= 0 && endCos <= 0 || startCos >= 0 && endCos >= 0 && startSin <= endSin || startCos <= 0 && endCos <= 0 && startSin >= endSin ? 1 : -_min(startSin, endSin, 0)
}
}
const dxCircularGauge = dxGauge.inherit({
_rootClass: "dxg-circular-gauge",
_factoryMethods: {
rangeContainer: "createCircularRangeContainer",
indicator: "createCircularIndicator"
},
_gridSpacingFactor: 17,
_scaleTypes: {
type: "polarAxes",
drawingType: "circular"
},
_getThemeManagerOptions() {
const options = this.callBase.apply(this, arguments);
options.subTheme = "_circular";
return options
},
_updateScaleTickIndent: function(scaleOptions) {
const indentFromTick = scaleOptions.label.indentFromTick;
const length = scaleOptions.tick.visible ? scaleOptions.tick.length : 0;
const textParams = this._scale.measureLabels(extend({}, this._canvas));
const scaleOrientation = scaleOptions.orientation;
const tickCorrection = length;
let indentFromAxis = indentFromTick;
if (indentFromTick >= 0) {
if ("outside" === scaleOrientation) {
indentFromAxis += tickCorrection
} else if ("center" === scaleOrientation) {
indentFromAxis += tickCorrection / 2
}
} else {
const labelCorrection = _max(textParams.width, textParams.height);
indentFromAxis -= labelCorrection;
if ("inside" === scaleOrientation) {
indentFromAxis -= tickCorrection
} else if ("center" === scaleOrientation) {
indentFromAxis -= tickCorrection / 2
}
}
scaleOptions.label.indentFromAxis = indentFromAxis;
this._scale.updateOptions(scaleOptions)
},
_setupCodomain: function() {
const geometry = this.option("geometry") || {};
let startAngle = geometry.startAngle;
let endAngle = geometry.endAngle;
let sides;
startAngle = _isFinite(startAngle) ? _normalizeAngle(startAngle) : 225;
endAngle = _isFinite(endAngle) ? _normalizeAngle(endAngle) : -45;
if (_abs(startAngle - endAngle) < 1) {
endAngle -= 360;
sides = {
left: -1,
up: -1,
right: 1,
down: 1
}
} else {
startAngle < endAngle && (endAngle -= 360);
sides = getSides(startAngle, endAngle)
}
this._area = {
x: 0,
y: 0,
radius: 100,
startCoord: startAngle,
endCoord: endAngle,
sides: sides
};
this._translator.setCodomain(startAngle, endAngle)
},
_getCenter: function() {
return this._getElementLayout()
},
_shiftScale: function(layout) {
const scale = this._scale;
const canvas = scale.getCanvas();
canvas.width = canvas.height = 2 * layout.radius;
scale.draw(canvas);
const centerCoords = scale.getCenter();
scale.shift({
right: layout.x - centerCoords.x,
bottom: layout.y - centerCoords.y
})
},
_getScaleLayoutValue: function() {
return this._area.radius
},
_getTicksOrientation: function(scaleOptions) {
return scaleOptions.orientation
},
_getTicksCoefficients: function(options) {
const coefs = {
inner: 0,
outer: 1
};
if ("inside" === options.orientation) {
coefs.inner = 1;
coefs.outer = 0
} else if ("center" === options.orientation) {
coefs.inner = coefs.outer = .5
}
return coefs
},
_correctScaleIndents: function(result, indentFromTick, textParams) {
if (indentFromTick >= 0) {
result.horizontalOffset = indentFromTick + textParams.width;
result.verticalOffset = indentFromTick + textParams.height
} else {
result.horizontalOffset = result.verticalOffset = 0;
result.min -= -indentFromTick + _max(textParams.width, textParams.height)
}
result.inverseHorizontalOffset = textParams.width / 2;
result.inverseVerticalOffset = textParams.height / 2
},
_measureMainElements: function(elements, scaleMeasurement) {
const radius = this._area.radius;
let maxRadius = 0;
let minRadius = 1 / 0;
let maxHorizontalOffset = 0;
let maxVerticalOffset = 0;
let maxInverseHorizontalOffset = 0;
let maxInverseVerticalOffset = 0;
const scale = this._scale;
_each(elements.concat(scale), (function(_, element) {
const bounds = element.measure ? element.measure({
radius: radius - element.getOffset()
}) : scaleMeasurement;
bounds.min > 0 && (minRadius = _min(minRadius, bounds.min));
bounds.max > 0 && (maxRadius = _max(maxRadius, bounds.max));
bounds.horizontalOffset > 0 && (maxHorizontalOffset = _max(maxHorizontalOffset, bounds.max + bounds.horizontalOffset));
bounds.verticalOffset > 0 && (maxVerticalOffset = _max(maxVerticalOffset, bounds.max + bounds.verticalOffset));
bounds.inverseHorizontalOffset > 0 && (maxInverseHorizontalOffset = _max(maxInverseHorizontalOffset, bounds.inverseHorizontalOffset));
bounds.inverseVerticalOffset > 0 && (maxInverseVerticalOffset = _max(maxInverseVerticalOffset, bounds.inverseVerticalOffset))
}));
maxHorizontalOffset = _max(maxHorizontalOffset - maxRadius, 0);
maxVerticalOffset = _max(maxVerticalOffset - maxRadius, 0);
return {
minRadius: minRadius,
maxRadius: maxRadius,
horizontalMargin: maxHorizontalOffset,
verticalMargin: maxVerticalOffset,
inverseHorizontalMargin: maxInverseHorizontalOffset,
inverseVerticalMargin: maxInverseVerticalOffset
}
},
_applyMainLayout: function(elements, scaleMeasurement) {
const measurements = this._measureMainElements(elements, scaleMeasurement);
const area = this._area;
const sides = area.sides;
const margins = {
left: (sides.left < -.1 ? measurements.horizontalMargin : measurements.inverseHorizontalMargin) || 0,
right: (sides.right > .1 ? measurements.horizontalMargin : measurements.inverseHorizontalMargin) || 0,
top: (sides.up < -.1 ? measurements.verticalMargin : measurements.inverseVerticalMargin) || 0,
bottom: (sides.down > .1 ? measurements.verticalMargin : measurements.inverseVerticalMargin) || 0
};
const rect = selectRectByAspectRatio(this._innerRect, (sides.down - sides.up) / (sides.right - sides.left), margins);
let radius = _min(getWidth(rect) / (sides.right - sides.left), getHeight(rect) / (sides.down - sides.up));
radius = radius - measurements.maxRadius + area.radius;
const x = rect.left - getWidth(rect) * sides.left / (sides.right - sides.left);
const y = rect.top - getHeight(rect) * sides.up / (sides.down - sides.up);
area.x = _round(x);
area.y = _round(y);
area.radius = radius;
rect.left -= margins.left;
rect.right += margins.right;
rect.top -= margins.top;
rect.bottom += margins.bottom;
this._innerRect = rect
},
_getElementLayout: function() {
let offset = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : 0;
return {
x: this._area.x,
y: this._area.y,
radius: _round(this._area.radius - offset)
}
},
_getApproximateScreenRange: function() {
const area = this._area;
let r = _min(this._canvas.width / (area.sides.right - area.sides.left), this._canvas.height / (area.sides.down - area.sides.up));
r > area.totalRadius && (r = area.totalRadius);
r *= .8;
return -this._translator.getCodomainRange() * r * PI / 180
},
_getDefaultSize: function() {
return {
width: 300,
height: 300
}
},
_factory: clone(BaseGauge.prototype._factory)
});
function getWidth(rect) {
return rect.right - rect.left
}
function getHeight(rect) {
return rect.bottom - rect.top
}
function selectRectByAspectRatio(srcRect, aspectRatio, margins) {
const rect = extend({}, srcRect);
let selfAspectRatio;
let width = 0;
let height = 0;
margins = margins || {};
if (aspectRatio > 0) {
rect.left += margins.left || 0;
rect.right -= margins.right || 0;
rect.top += margins.top || 0;
rect.bottom -= margins.bottom || 0;
if (getWidth(rect) > 0 && getHeight(rect) > 0) {
selfAspectRatio = getHeight(rect) / getWidth(rect);
if (selfAspectRatio > 1) {
aspectRatio < selfAspectRatio ? width = getWidth(rect) : height = getHeight(rect)
} else {
aspectRatio > selfAspectRatio ? height = getHeight(rect) : width = getWidth(rect)
}
width > 0 || (width = height / aspectRatio);
height > 0 || (height = width * aspectRatio);
width = (getWidth(rect) - width) / 2;
height = (getHeight(rect) - height) / 2;
rect.left += width;
rect.right -= width;
rect.top += height;
rect.bottom -= height
} else {
rect.left = rect.right = (rect.left + rect.right) / 2;
rect.top = rect.bottom = (rect.top + rect.bottom) / 2
}
}
return rect
}
const indicators = dxCircularGauge.prototype._factory.indicators = {};
dxCircularGauge.prototype._factory.createIndicator = createIndicatorCreator(indicators);
indicators._default = circularIndicators._default;
indicators.rectangleneedle = circularIndicators.rectangleneedle;
indicators.triangleneedle = circularIndicators.triangleneedle;
indicators.twocolorneedle = circularIndicators.twocolorneedle;
indicators.trianglemarker = circularIndicators.trianglemarker;
indicators.textcloud = circularIndicators.textcloud;
indicators.rangebar = circularIndicators.rangebar;
dxCircularGauge.prototype._factory.RangeContainer = CircularRangeContainer;
registerComponent("dxCircularGauge", dxCircularGauge);
dxCircularGauge.addPlugin(centerTemplatePlugins.gauge);
export default dxCircularGauge;