Progress bar
Last updated
Last updated
The Progress bar widget offers a minimalistic way to display percentages, making it ideal for showing data from your devices' capabilities. Whether it's tracking battery level, capacity, or any other metric, this widget provides a simple and effective visual representation.
For advanced users, the widget can accept a percentage value set by a DataVista action card.
The configuration allows you to customize two colors: one for 0% and one for 100%, with the bar dynamically changing its color based on the percentage value, giving you a clear and intuitive visual of your data.
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 "Progress bar" 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 it, you can customize the widget to display the progress of specific devices or metrics based on your needs.
The widget has the following configurable settings:
Datasource
Select either a DataVista percentage value*, DataVista range value*, device capability or Homey variable to use for the progress bar value.
Refresh Interval
When a device capability is selected, this determines how often the widget updates to reflect new values.
Show Icon
Enable to show the capability or device icon (if available), with priority given to the capability icon.
Show Name
If enabled, displays the device and capability name below the progress bar.
Overwrite Name
If set, this name will be displayed below the progress bar instead of the device and capability name.
Color 1
The color for when the percentage is at 0%.
Color 2
The color for when the percentage is at 50%.
Color 3
The color for when the percentage is at 100%.
Issue: Disabling the "Show name" setting causes the widget to remain stuck on the loading screen when the dashboard is reopened.
Resolution: Athom has acknowledged this issue and has confirmed that it will be fixed in an upcoming release. In the meantime, please avoid disabling the "Show name" setting to ensure proper functionality.
To use a DataVista percentage value or DataVista range 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.
You are allowed to configure just one, two or all three colors. The colors will spread evenly across the progress bar.
In this section, you'll find answers to common questions and troubleshooting tips for the progress bar widget. If you're experiencing any issues, the solutions here can help guide you through resolving them.
If the progress bar is animating in steps from 0 to 25, 50, 75, and 100, and then back, 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.
To use a single color for the entire progress bar, select the same color for both Color 1 and Color 2 in the widget settings. This will ensure the progress bar displays the same color at all values.
The Homey app does not allow for color input fields in widget settings. To work within this limitation, I’ve created a dropdown of colors that are commonly used and likely to meet most users' needs.
The widget checks for an icon associated with the selected capability. If no icon is found for that capability, it will automatically fall back to displaying the device icon instead.
Make sure the "Show Icon" setting is enabled in the widget settings. Additionally, please note that icons are currently only supported for device capabilities and not for DataVista percentage values.
