Skip to the content

ProgressBar

ProgressBar shows how far a task with a known percentage has progressed. progress runs from 0 to 100; values outside that range are clamped for the fill, the label and aria-valuenow.
Feedback & Loading

When to use

Use when
  • An upload, download or import reports a percentage.
  • A multi-step flow should show how much is left.
Avoid when
  • The duration is unknown — use Spinner.
  • The bar shows a measurement (quota, score), not task progress — use Meter.

Usage

loading
<ProgressBar progress={42} />
<ProgressBar progress={75} color="success" showProgressLabel />
<ProgressBar progress={100} size="large" border aria-label="Upload" />

color and size share the Button palette and size scale. border rounds the corners; showProgressLabel prints the percentage next to the bar.

Accessibility

  • Renders role="progressbar" with aria-valuemin={0}, aria-valuemax={100} and the clamped aria-valuenow.
  • Native attributes pass through to the container: give the bar an aria-label that names the task.

Properties

See also