Gauge Widget

Last updated

A semicircular gauge with a needle, a colored arc and the value underneath.

Settings

Setting	Description	Default
Minimum	Left end of the scale, in displayed units	0
Maximum	Right end of the scale	100
Unit	Shown after the number (or before, see Unit position)	%
Decimals	Decimal places of the number	1 (see below)
Multiply by	Scales the value before it is drawn and printed	1
Unit position	After the value or Before the value	After
Group thousands	Digit grouping in the printed number	off
Value labels	JSON map of value → text for the printed number	none
Warning	Percent of the scale at which the arc turns amber	70
Critical	Percent of the scale at which the arc turns red	90
Color	Arc color below the warning threshold	#3b82f6 (blue)

How the thresholds work

Warning and Critical are percentages of the span, not values. On a gauge from 0 to 250 RPM with Warning 70 and Critical 90, the arc turns amber at 175 RPM and red at 225 RPM. On a gauge from 50 to 150, Warning 70 means 120.

Behavior

• The needle is clamped at the ends: a value below Minimum points at the left end, above Maximum at the right end, while the number shows the real value.
• A value that is not a number draws no needle and no arc, and prints the text that arrived.
• Minimum and Maximum labels are printed as typed, without formatting.
• Until you change Decimals, whole values print with no decimal and others with one (50 → "50", 50.44 → "50.4").
• If Minimum equals Maximum the needle stays at the left.

Example

Feed rate 0–250 mm/min: Minimum 0, Maximum 250, Unit mm/min, Warning 80, Critical 95. Bind value to the feed-rate tag. For a tag holding a 0–1 fraction shown as 0–100 %, set Multiply by 100 and Unit %.

See also

• Formatting Values
• Progress Bar Widget
• Value Widget