Status badge
Last updated
Last updated
The Status Badge widget in DataVista offers a compact and visually impactful way to display status information. Designed for short status texts, this widget provides customizable color options to match your visual preferences or indicate importance. For added emphasis, the Status Badge includes an optional pulsing effect to draw attention when needed. With two distinct style variants—Badge and Bullet—you can choose the presentation that best fits your design or context, making it a versatile tool for communicating statuses effectively.
The widget can be controlled using an existing boolean capability, a Homey boolean variable, or dynamically through DataVista action cards. The DataVista Boolean action card provides straightforward control, while the Status action card unlocks advanced capabilities, such as dynamically configuring colors and attracting attention.
To add the progress bar widget to your dashboard, follow these simple steps:
Open your Homey app and go to the Dashboards section.
Enter Edit Mode and select the "Add Widget" button.
Select "Apps" at the top and look for the app called "DataVista".
Look for the Status badge widget. You can easily identify it by the preview image (as shown below).
Once you find it, click on the widget preview to add it to your dashboard.
After adding the widget, you can customize it to reflect specific statuses.
Datasource
Select either a DataVista value*, device capability or Homey variable to use as the status source.
Refresh Interval
When a device capability or Homey variable is selected, this determines how often the widget updates to reflect new values.
Style
Defines the visual appearance of the status badge. You can choose between three styles: Badge, Bullet or Named bullet.
Overwrite name
Defines the name displayed alongside the status badge. By default, it is set to Status
. When the style is set to Badge, the name will be shown on the left of the badge.
Width of name
Specifies the width of the status badge name. This is useful for aligning multiple badges displayed below each other by ensuring consistent widths.
True text
Defines the text displayed when the data source is a boolean and its value is true
.
False text
Defines the text displayed when the data source is a boolean and its value is false
.
Color if true
Defines the color when the datasource is a boolean and its value is true
.
Color if false
Defines the color when the datasource is a boolean and its value is false
.
To use a DataVista value, you must first create a flow that sets this value using a DataVista action card. The flow needs to be run once initially in order to make the value visible and selectable in the widget settings. After running the flow, the value will appear at the top of the list in the Datasource setting.
If the status badge is showing "Configure me" and is in demo mode (meaning it transitions between true
and false
states continuously), it indicates that the datasource could not be found (or is no longer available). This typically happens when the selected datasource is removed. To resolve this issue, try reconfiguring the datasource setting and ensure the correct value is selected.
This can only be set using the DataVista Status action card. Use that to set the status and set the attract attention
option to Yes
.