An indicator is essentially a card that can be added to your dashboard. It can be used to display the count of features or a show a summary statistic such as a sum, average, minimum or maximum. Additionally, it can be configured to compare its computed value to a reference value. Last, it can be configured to only show an icon or change its color in response to conditional thresholds being met. The following are just some examples of the many configurations possible with the indicator.
Like many dashboard elements, the indicator has a title area, an area for the visualization itself, and a description area (for more information, see Configure an element). On an indicator, the area for the visualization can be broken into three areas: top, middle, and bottom. Each of the three areas is optional, and can have text displayed. This text can be any combination of the indicator's value, its reference value (if specified), a pre-defined list of calculations, or hardcoded text. As the indicator is resized, the text displayed in the top, middle and bottom areas scales to fit the size of the indicator.
The pre-defined calculations available for an indicator are below. They can be inserted into the top, middle or bottom text fields by clicking Insert .
Value - Reference
|Value - Reference|
100 * Value / Reference
100 * (Value - Reference) / Reference
Value / Reference
(Value - Reference) / Reference
When specifying top, middle or bottom text, HTML codes can be used. If you can't find a desired symbol on your keyboard, you can copy and paste it from another website directly into the text settings, or you can enter the symbol's decimal (dec) or hexadecimal (hex) reference code in these settings. For example, to include an upward pointing triangle (▲) in the indicator, you can insert its dec code of ▲ or its hex code of ▲ into the text settings. See Effective use of HTML for details.
The middle text is unique because it can have an icon displayed to the left or right of the text. These icons are scalable vector graphics (SVG) and like the text itself, will resize as the indicator resizes. If the provided SVG icons are insufficient, you can use your own. For more information, see Use custom icons.
Reference values on indicators are optional, and when specified can be thought of as a predefined goal or threshold. There are three types of reference values: the indicator's previous value, a fixed value set at design time, or a statistic calculated at runtime. If you set a reference value, you can also configure conditional formatting for the indicator. Conditional formatting enables an indicator to display differently based on whether the current value is at or above the reference value, or below it. In the following example, a red or green triangle is used to indicate whether completed tasks have increased or decreased from the previous day's totals, respectively.
You can also apply techniques like value conversion, unit prefixing, and number formatting to the indicator. Finally, indicators can be used in interactive dashboards as the target of an action. This means that an action performed on another element, such as a selection on a list or a category selector, can control the data available to be displayed on the indicator.