Linear Gauge

Displays a numeric value in a vertical or horizontal linear gauge.

Linear Gauge Component


Gauge OptionsGauge OptionsConfigure parameters that control the appearance of the gauge
ValueNumericSet a static or dynamic value bound to an OAS Tag
Value ColorColorThe fill color that indicates the current value
Value FontFontThe font used for the label that displays the current numeric value
LabelStringThe static label displayed on the gauge
Label FontFontThe font used for the text label on the gauge
BG ColorColorBackground or fill color behind the component
BorderBorderOptional border around the Component
Text ColorColorThe color used for both the numeric value and label text
VisibilityBooleanDetermines when to show or hide the Component
FlashBooleanCauses the Component to flash, drawing attention to it

Gauge Options

Options for customizing the appearance of the gauge

OrientationAllows you to display the gauge either horizontally or vertically
PaddingIn pixels, the padding between the gauge and the Component edge
DirectionThe direction in which the value fills the gauge. By default, the gauge will fill from left to right when it is horizontal, and from the bottom up when vertical. Reversing the direction will cause the gauge to fill from right to left or top down
Value Min/MaxThe numeric minimum and maximum represented on the gauge and used to determine the value fill percentage
EndcapThe gauge shape can use either a flat or rounded endcap.
Flat Rounded
Width/Pad/BGControls the width of the value fill, the background padding around it, and the background padding color
Value Format/UnitsYou can use a numeric formatting string to determine how the value label will display the current value. For example, if you want to round a floating point value of 3.14159 to two decimal places, you can use 0.00 as the format to display in 3.14. The optional Units field is a string to append to the value, so entering a string of psi will display 3.14 psi.
Tick CountSets the number of Ticks, both major and minor, when Tick Location is not set to none. Major Ticks are rendered based on a the value range. For example, if the Min and Max are set to 0 and 100, and the Major Ticks is set to 6, you will see one tick every 20 steps.
Major Ticks
Minor Ticks are the number of ticks between Major Ticks. For example, setting Minor Ticks to 3 in the example above will indicate value increments of 5
Minor Ticks
Tick LocationFor vertical gauges, Ticks can be placed on the left, right, or both locations. For horizontal, the locations can be top, bottom, or both. Setting this to none will hide all Ticks. Additionally, the Offset allows you to position the ticks farther or closer to the value fill color.
Tick ColorThe color used for the Tick lines
Tick SizeIndependently set the length of both Major and Minor Tick lines
NumeralsSimilar to Tick Location, you can choose to place the numeric labels that appear in the Major Tick position where you prefer. For vertical gauges, this can be on the left, right, both, or center of the gauge. For horizontal gauges, the positions are top, bottom, both or center. And setting this to none will hide the numerals. As with Ticks, you can also set an Offset for adjusting the position of the labels. You can also set the size of the numeral labels.
Numeral Color/FormatThe color of the numeric labels and numeric format to apply, similar to the Value Format
Last Updated: