Function: a!gaugeField()
Displays a completion percentage in a circlar style similar to the Progress Bar. Best used for showing progress when there is a target value, such as the number of completed surveys out of 360 total surveys, or number of hired employees out of 20 total open positions.
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Text to display as the field label. |
Label Position |
|
Text |
Determines where the label appears. Valid values:
|
Instructions |
|
Text |
Supplemental text about this field. |
Help Tooltip |
|
Text |
Displays a help icon with the specified text as a tooltip. The tooltip displays a maximum of 500 characters. The help icon does not show when the label position is |
Percentage |
|
Number (Decimal) |
Number to display between 0 and 100. |
Primary Text |
|
Text |
Optional text to display on the first line inside the gauge. |
Secondary Text |
|
Text |
Optional text to display on the second line inside the gauge. |
Color |
|
Text |
Determines the color. Valid values: Any valid hex color or |
Size |
|
Text |
Determines the size of the gauge. Valid values: |
Align |
|
Text |
Determines alignment of the gauge. Valid values: |
Accessibility Text |
|
Text |
Additional text to be announced by screen readers. Used only for accessibility; produces no visible change. |
Visibility |
|
Boolean |
Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true. |
Notes
Copy and paste an example into the INTERFACE DEFINITION in EXPRESSION MODE to see it displayed.
Gauge Showing Number Complete
1
2
3
4
5
6
=a!gaugeField(
label: "Evaluations Completed",
percentage: (25 / 26) * 100,
primaryText: "25",
secondaryText: "of 26"
)
Displays the following:
Gauge Showing Percent Complete
1
2
3
4
5
=a!gaugeField(
label: "Evaluations Completed",
percentage: (25 / 26) * 100,
primaryText: round((25 / 26) * 100, 0) & "%"
)
Displays the following:
On This Page