Components
Progress
A visual bar indicating the completion status of a task or process.
Overview
Progress displays a visual bar indicating how much of a task or process has been completed. It supports determinate (known percentage) and indeterminate (loading) states.
Default50%
Success100%
Warning80%
Destructive90%
Indeterminate
Usage
export function Example() {
return <Progress value={42} label="Uploading" showValue />;
}Variants
Default
<Progress value={50} label="Loading" />Success
<Progress value={100} variant="success" label="Complete" />Warning
<Progress value={80} variant="warning" label="Storage" showValue />Destructive
<Progress value={90} variant="destructive" label="Critical" showValue />Sizes
| Size | Height |
|---|---|
sm | 4px |
md | 8px (default) |
lg | 16px |
States
Indeterminate
<Progress indeterminate label="Loading..." />Accessibility
role="progressbar"witharia-valuenow,aria-valuemin,aria-valuemaxaria-valuetextprovides human-readable value ("42 percent" or "Loading")aria-labelfor accessible name
API Reference
| Prop | Type | Default | Description |
|---|---|---|---|
value | number | 0 | Current value |
max | number | 100 | Maximum value |
label | string | — | Accessible label |
showValue | boolean | false | Display percentage |
variant | 'default' | 'success' | 'warning' | 'destructive' | 'default' | Color variant |
size | 'sm' | 'md' | 'lg' | 'md' | Bar thickness |
indeterminate | boolean | false | Unknown progress |