Progress Widget
Progress widgets visually represent how a numeric value (actual) compares against a defined target. These are ideal for displaying KPIs, completion percentages, or performance metrics.
📊 Basic Configuration
| Configuration Item | Description |
|---|---|
| Source | The dataset providing values for actual and target measures. |
| Actual Measure | Numeric value representing achieved or completed progress. |
| Target Measure | Numeric value representing the total or goal to achieve. |
| Date (optional) | Can be used to filter or contextualize the data over time. |
🎨 Widget Customizations
All progress widgets share these customization sections:
| Group | Description |
|---|---|
| General | Modify the widget’s appearance — background, borders, shadows, and interactions. |
| Title | Customize title text, alignment, font, and color. |
| Progress | Define ring/bar properties, steps, actual/target labels, separators, icons, and measure formatting. |
📏 Progress Widget
A linear progress bar displaying actual vs target values as a horizontal bar.
Key Features:
- Supports custom bar colors and backgrounds.
- Optional thresholds (steps) to change colors based on value ranges.
- Position actual and target values with label formatting.
- Configurable separator and icon display.
- Adjustable value formatting (prefix, suffix, precision, percentage/value switch).
📊 Ring Progress Widget
A circular ring-based progress visualization comparing an actual value against a target.
Key Features:
- Customizable ring size, thickness, and cap style.
- Optional stepped coloring for thresholds.
- Independently position actual and target labels.
- Add separators and icons with flexible positioning.
- Format labels as value or percentage with precision and formatting options.