Skip to content

Progress

A progress bar on Base UI Progress.

For progress that can be measured. The fill moves to a new value over 300ms, and at once with reduced motion. With value={null} the item draws an empty track, so use @khaeli/spinner or @khaeli/loader when the amount is not known.

Default

x

With label and value

Importing tasks
x

Changing value

Uploading the release notes
x

Steps of a range

Launch checklist
x

Installation

npx shadcn@latest add @khaeli/progress

Install @khaeli/foundation first: this item's styling lives in its tokens and [data-slot] rules.

Installs with

Registry items
npm packages
  • @base-ui/react ^1.7.0

Accessible name

  • The bar is a progressbar and needs a name: ProgressLabel inside it names it, and without one pass aria-label.
  • The value is read as a percentage of min to max (38%). When a percentage is the wrong reading, getAriaValueText says it in words (3 of 8 tasks done) and a function as the child of ProgressValue writes the visible text.

Registry JSON

The item as the shadcn CLI reads it, with every file it ships: https://ui.khaeli.com/r/progress.json