Displays an indicator showing the completion progress of a task, typically displayed as a progress bar.
Installation
CLI
Install the component using the StarUI CLI:
Examples
With Label
Progress bar with a label and reactive percentage readout
Upload progress
Sizes
Height variants using Tailwind classes via cls
h-1
h-2
h-3
h-4
Reactive
Signal-driven progress bar with controls to update the value
Multi-Step Loading
Sequenced deployment pipeline with step labels [seq(), set_timeout, switch()]
API Reference
Props
| Prop | Type | Default | Description |
|---|---|---|---|
value |
float | None |
None |
Initial value in the range [0, max_value]. When omitted with Signal object, uses Signal's initial value. |
max_value |
float |
100 |
Maximum value that represents 100% |
signal |
str | Signal |
auto-generated |
Signal name or Signal object for reactive updates |
cls |
str |
'' |
Additional CSS classes (e.g., 'h-1', 'h-3', 'h-4') |