Progress
A flexible progress bar component that visually indicates task completion and supports multiple sections for complex progress tracking.
A flexible progress bar component that visually indicates task completion and supports multiple sections for complex progress tracking.
Basic usage example to quickly see how the Progress
works.
Interactive configurator to explore customization options for the Progress
component.
type ProgressState = "complete" | "indeterminate" | "loading";
Data Attributes | Values | Annotation |
---|---|---|
["data-state"] | ProgressState | available on Root & Section |
["data-value"] | Current value | available on Root & Section |
["data-min"] | Min value | available on Root & Section |
["data-max"] | Max value | available on Root & Section |
["data-striped"] | "true" | undefined | available on Section |
["data-animated"] | "true" | undefined | available on Section |
Aria Attributes | Values | Annotation |
---|---|---|
["aria-label"] | label prop | available on Section |
["aria-valuemin"] | Min value | available on Section |
["aria-valuemax"] | Max value | available on Section |
["aria-valuenow"] | Current value | available on Section |
["aria-valuetext"] | Current value + "%" | available on Section |
Styles API | Type | Default | Annotation |
---|---|---|---|
classNames? | Partial<Record<Selector, string>> | undefined | --- |
styles? | Partial<Record<Selector, CSSProperties>> | undefined | --- |
Props API | Type | Default | Annotation |
---|---|---|---|
value | number | --- | Value of the progress |
color? | Color | ((value: number) => Color) | --- | Key of colors or any valid CSS value |
striped? | boolean | false | Determines whether the section should have stripes |
animated? | boolean | false | Determines whether the sections stripes should be animated, if set, striped prop is ignored. |
size? | (string & {}) | number | Controls track height. | |
round? | (string & {}) | number | 9999px | Key of radius or any valid CSS value to set border-radius . |
transitionDuration? | number | 100 | Controls sections width transition duration, value is specified in ms. |
Full working code example, including necessary markup and styles. You can copy and paste this code directly to start using the component immediately.