Progress

Displays the status of a task that takes a long time.

API reference

Import the component and assemble its parts:

Anatomy
import { Progress } from '@base-ui-components/react/progress';
<Progress.Root>  <Progress.Track>    <Progress.Indicator />  </Progress.Track></Progress.Root>

Root

Groups all parts of the progress bar and provides the task completion status to screen readers. Renders a <div> element.

PropTypeDefault
aria-label

string

undefined

aria-labelledby

string

undefined

value

number

null

aria-valuetext

string

undefined

getAriaLabel

(value) => string

undefined

getAriaValueText

(value) => string

undefined

min

number

0

max

number

100

className

string | (state) => string

undefined

render

| React.ReactElement
| (props, state) => React.ReactElement

undefined

Attribute
Description
data-complete
data-indeterminate
data-progressing

Track

Contains the progress bar indicator. Renders a <span> element.

PropTypeDefault
className

string | (state) => string

undefined

render

| React.ReactElement
| (props, state) => React.ReactElement

undefined

Attribute
Description
data-complete
data-indeterminate
data-progressing

Indicator

Visualizes the completion status of the task. Renders a <span> element.

PropTypeDefault
className

string | (state) => string

undefined

render

| React.ReactElement
| (props, state) => React.ReactElement

undefined

Attribute
Description
data-complete
data-indeterminate
data-progressing