Progress
Shows how much of a task or process is complete.
Installation
Install Progress from Oros with shadcn CLI 4.13.0.
pnpm dlx shadcn@4.13.0 add @oros/progressUsage
import {
Progress,
ProgressTrack,
ProgressIndicator,
ProgressLabel,
ProgressValue,
} from "@/components/ui/progress"Open the Source tab in the preview for a complete working example.
Anatomy
| Export | Responsibility |
|---|---|
| Progress | The root component that owns the primary structure and state. |
| ProgressTrack | Provides the visual range used by an indicator or thumb. |
| ProgressIndicator | Shows the current state, value, or selection. |
| ProgressLabel | Provides a visible label for its related control or value. |
| ProgressValue | Displays or exposes the current value. |
API Reference
Progress exports 5 named entries. Component exports accept the props of their underlying HTML element or Base UI component, plus an optional className, unless the source defines a more focused type.
ProgressComponentProgressTrackComponentProgressIndicatorComponentProgressLabelComponentProgressValueComponent
Accessibility
- Progress adds no application-specific accessible name by itself; use semantic content and label any interactive descendants.
- Do not communicate state or meaning through color alone, and verify the composed result at text zoom and with keyboard navigation.
Source
Progress uses the standard shadcn API and is distributed through Oros. Installing it adds the component source and required dependencies to your app. The Source tab above shows a complete usage example.