| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358 |
- /* *
- *
- * Solid angular gauge module
- *
- * (c) 2010-2021 Torstein Honsi
- *
- * License: www.highcharts.com/license
- *
- * !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
- 'use strict';
- var __extends = (this && this.__extends) || (function () {
- var extendStatics = function (d, b) {
- extendStatics = Object.setPrototypeOf ||
- ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
- function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
- return extendStatics(d, b);
- };
- return function (d, b) {
- extendStatics(d, b);
- function __() { this.constructor = d; }
- d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
- };
- })();
- import LegendSymbolMixin from '../../Mixins/LegendSymbol.js';
- import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
- var _a = SeriesRegistry.seriesTypes, GaugeSeries = _a.gauge, pieProto = _a.pie.prototype;
- import SolidGaugeAxis from '../../Core/Axis/SolidGaugeAxis.js';
- import U from '../../Core/Utilities.js';
- var clamp = U.clamp, extend = U.extend, isNumber = U.isNumber, merge = U.merge, pick = U.pick, pInt = U.pInt;
- import './SolidGaugeComposition.js';
- /**
- * A solid gauge is a circular gauge where the value is indicated by a filled
- * arc, and the color of the arc may variate with the value.
- *
- * @sample highcharts/demo/gauge-solid/
- * Solid gauges
- *
- * @extends plotOptions.gauge
- * @excluding dial, pivot, wrap
- * @product highcharts
- * @requires modules/solid-gauge
- * @optionparent plotOptions.solidgauge
- */
- var solidGaugeOptions = {
- /**
- * The inner radius for points in a solid gauge. Can be given as a number
- * (pixels) or percentage string.
- *
- * @sample {highcharts} highcharts/plotoptions/solidgauge-radius/
- * Individual radius and innerRadius
- *
- * @type {number|string}
- * @default 60
- * @since 4.1.6
- * @product highcharts
- * @apioption plotOptions.solidgauge.innerRadius
- */
- /**
- * Whether the strokes of the solid gauge should be `round` or `square`.
- *
- * @sample {highcharts} highcharts/demo/gauge-activity/
- * Rounded gauge
- *
- * @type {string}
- * @default round
- * @since 4.2.2
- * @product highcharts
- * @validvalue ["square", "round"]
- * @apioption plotOptions.solidgauge.linecap
- */
- /**
- * Allow the gauge to overshoot the end of the perimeter axis by this
- * many degrees. Say if the gauge axis goes from 0 to 60, a value of
- * 100, or 1000, will show 5 degrees beyond the end of the axis when this
- * option is set to 5.
- *
- * @type {number}
- * @default 0
- * @since 3.0.10
- * @product highcharts
- * @apioption plotOptions.solidgauge.overshoot
- */
- /**
- * The outer radius for points in a solid gauge. Can be given as a number
- * (pixels) or percentage string.
- *
- * @sample {highcharts} highcharts/plotoptions/solidgauge-radius/
- * Individual radius and innerRadius
- *
- * @type {number|string}
- * @default 100
- * @since 4.1.6
- * @product highcharts
- * @apioption plotOptions.solidgauge.radius
- */
- /**
- * Wether to draw rounded edges on the gauge.
- *
- * @sample {highcharts} highcharts/demo/gauge-activity/
- * Activity Gauge
- *
- * @type {boolean}
- * @default false
- * @since 5.0.8
- * @product highcharts
- * @apioption plotOptions.solidgauge.rounded
- */
- /**
- * The threshold or base level for the gauge.
- *
- * @sample {highcharts} highcharts/plotoptions/solidgauge-threshold/
- * Zero threshold with negative and positive values
- *
- * @type {number|null}
- * @since 5.0.3
- * @product highcharts
- * @apioption plotOptions.solidgauge.threshold
- */
- /**
- * Whether to give each point an individual color.
- */
- colorByPoint: true,
- dataLabels: {
- y: 0
- }
- };
- /* *
- *
- * Class
- *
- * */
- /**
- * SolidGauge series type.
- *
- * @private
- * @class
- * @name Highcharts.seriesTypes.solidgauge
- *
- * @augments Highcarts.Series
- */
- var SolidGaugeSeries = /** @class */ (function (_super) {
- __extends(SolidGaugeSeries, _super);
- function SolidGaugeSeries() {
- /* *
- *
- * Static properties
- *
- * */
- var _this = _super !== null && _super.apply(this, arguments) || this;
- /* *
- *
- * Properties
- *
- * */
- _this.data = void 0;
- _this.points = void 0;
- _this.options = void 0;
- _this.axis = void 0;
- _this.yAxis = void 0;
- _this.startAngleRad = void 0;
- _this.thresholdAngleRad = void 0;
- return _this;
- }
- /* *
- *
- * Functions
- *
- * */
- // Extend the translate function to extend the Y axis with the necessary
- // decoration (#5895).
- SolidGaugeSeries.prototype.translate = function () {
- var axis = this.yAxis;
- SolidGaugeAxis.init(axis);
- // Prepare data classes
- if (!axis.dataClasses && axis.options.dataClasses) {
- axis.initDataClasses(axis.options);
- }
- axis.initStops(axis.options);
- // Generate points and inherit data label position
- GaugeSeries.prototype.translate.call(this);
- };
- // Draw the points where each point is one needle.
- SolidGaugeSeries.prototype.drawPoints = function () {
- var series = this, yAxis = series.yAxis, center = yAxis.center, options = series.options, renderer = series.chart.renderer, overshoot = options.overshoot, overshootVal = isNumber(overshoot) ?
- overshoot / 180 * Math.PI :
- 0, thresholdAngleRad;
- // Handle the threshold option
- if (isNumber(options.threshold)) {
- thresholdAngleRad = yAxis.startAngleRad + yAxis.translate(options.threshold, null, null, null, true);
- }
- this.thresholdAngleRad = pick(thresholdAngleRad, yAxis.startAngleRad);
- series.points.forEach(function (point) {
- // #10630 null point should not be draw
- if (!point.isNull) { // condition like in pie chart
- var graphic = point.graphic, rotation = (yAxis.startAngleRad +
- yAxis.translate(point.y, null, null, null, true)), radius = ((pInt(pick(point.options.radius, options.radius, 100)) * center[2]) / 200), innerRadius = ((pInt(pick(point.options.innerRadius, options.innerRadius, 60)) * center[2]) / 200), shapeArgs, d, toColor = yAxis.toColor(point.y, point), axisMinAngle = Math.min(yAxis.startAngleRad, yAxis.endAngleRad), axisMaxAngle = Math.max(yAxis.startAngleRad, yAxis.endAngleRad), minAngle, maxAngle;
- 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);
- }
- minAngle = Math.min(rotation, series.thresholdAngleRad);
- maxAngle = Math.max(rotation, series.thresholdAngleRad);
- if (maxAngle - minAngle > 2 * Math.PI) {
- maxAngle = minAngle + 2 * Math.PI;
- }
- point.shapeArgs = shapeArgs = {
- x: center[0],
- y: center[1],
- r: radius,
- innerR: innerRadius,
- start: minAngle,
- end: maxAngle,
- rounded: options.rounded
- };
- 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.
- SolidGaugeSeries.prototype.animate = function (init) {
- if (!init) {
- this.startAngleRad = this.thresholdAngleRad;
- pieProto.animate.call(this, init);
- }
- };
- SolidGaugeSeries.defaultOptions = merge(GaugeSeries.defaultOptions, solidGaugeOptions);
- return SolidGaugeSeries;
- }(GaugeSeries));
- extend(SolidGaugeSeries.prototype, {
- drawLegendSymbol: LegendSymbolMixin.drawRectangle
- });
- SeriesRegistry.registerSeriesType('solidgauge', SolidGaugeSeries);
- /* *
- *
- * Default export
- *
- * */
- export default SolidGaugeSeries;
- /**
- * A `solidgauge` series. If the [type](#series.solidgauge.type) option is not
- * specified, it is inherited from [chart.type](#chart.type).
- *
- *
- * @extends series,plotOptions.solidgauge
- * @excluding animationLimit, boostThreshold, connectEnds, connectNulls,
- * cropThreshold, dashStyle, dataParser, dataURL, dial,
- * findNearestPointBy, getExtremesFromAll, marker, negativeColor,
- * pointPlacement, pivot, shadow, softThreshold, stack, stacking,
- * states, step, threshold, turboThreshold, wrap, zoneAxis, zones,
- * dataSorting, boostBlending
- * @product highcharts
- * @requires modules/solid-gauge
- * @apioption series.solidgauge
- */
- /**
- * An array of data points for the series. For the `solidgauge` series
- * type, points can be given in the following ways:
- *
- * 1. An array of numerical values. In this case, the numerical values will be
- * interpreted as `y` options. Example:
- * ```js
- * data: [0, 5, 3, 5]
- * ```
- *
- * 2. An array of objects with named values. The following snippet shows only a
- * few settings, see the complete options set below. If the total number of
- * data points exceeds the series'
- * [turboThreshold](#series.solidgauge.turboThreshold), this option is not
- * available.
- * ```js
- * data: [{
- * y: 5,
- * name: "Point2",
- * color: "#00FF00"
- * }, {
- * y: 7,
- * name: "Point1",
- * color: "#FF00FF"
- * }]
- * ```
- *
- * The typical gauge only contains a single data value.
- *
- * @sample {highcharts} highcharts/chart/reflow-true/
- * Numerical values
- * @sample {highcharts} highcharts/series/data-array-of-objects/
- * Config objects
- *
- * @type {Array<number|null|*>}
- * @extends series.gauge.data
- * @product highcharts
- * @apioption series.solidgauge.data
- */
- /**
- * The inner radius of an individual point in a solid gauge. Can be given as a
- * number (pixels) or percentage string.
- *
- * @sample {highcharts} highcharts/plotoptions/solidgauge-radius/
- * Individual radius and innerRadius
- *
- * @type {number|string}
- * @since 4.1.6
- * @product highcharts
- * @apioption series.solidgauge.data.innerRadius
- */
- /**
- * The outer radius of an individual point in a solid gauge. Can be
- * given as a number (pixels) or percentage string.
- *
- * @sample {highcharts} highcharts/plotoptions/solidgauge-radius/
- * Individual radius and innerRadius
- *
- * @type {number|string}
- * @since 4.1.6
- * @product highcharts
- * @apioption series.solidgauge.data.radius
- */
- ''; // adds doclets above to transpiled file
|