Skip to Content
ComponentsProgress

Progress

A progress bar built on Base UI’s Progress primitive. Supports determinate values and an indeterminate loading state.

Import

import { Progress } from "chunks-ui";

Basic Usage

Pass value and max to show a determinate progress bar:

<Progress.Root value={65} max={100}> <Progress.Track> <Progress.Indicator /> </Progress.Track> </Progress.Root>
Upload progress65%

Indeterminate

Omit value (or pass null) to activate the indeterminate pulse animation:

<Progress.Root> <Progress.Track> <Progress.Indicator /> </Progress.Track> </Progress.Root>
Loading…

Multiple Values

Step 0.410%
Step 1.640%
Step 375%
Step 4100%

Compound Parts

PartDescription
Progress.RootState container. Holds value, max, and exposes data-indeterminate when no value is set.
Progress.TrackThe background rail. Full-width pill shape.
Progress.IndicatorFills the track proportionally. Pulses when indeterminate.

Progress.Root Props

PropTypeDefaultDescription
valuenumber | nullnullCurrent progress value. null triggers indeterminate state.
maxnumber100Maximum value
aria-labelstringAccessible label for the progress bar
classNamestringAdditional CSS classes
Last updated on