Skip to main content

Progress

Progress bar indicator for determinate or indeterminate operations. Reach for progress when a task has a measurable duration or completion percentage the user benefits from seeing. Omit value to render an indeterminate bar for operations without a known duration.

Usage​

When to use

  • Long-running operations with a known completion percentage
  • File uploads or downloads
  • Multi-step flows where overall progress is meaningful

When not to use

  • Stepped or ordered progress between named stages - use the Steps component
  • Brief operations under half a second - use nothing
  • Indeterminate loading for a specific area - use the Loading component

Do

  • Provide accessible min/max/now values
  • Use determinate progress when progress can be measured
  • Keep progress visible while the operation runs

Don't

  • Hide progress the moment it completes without user feedback

API​

Props​

PropTypeDefaultDescription
labelstring-Accessible label applied via aria-label.
valuenumber-Current progress value. Omit for indeterminate state.
maxnumber-Maximum value.
classesarray-Additional CSS class words merged into the root element.
attributesobject-Additional HTML attributes spread on the root element.

Classes​

ClassCapabilityDefaultDescription
.infoIntent-Informational message.
.warningIntent-Warning or caution.
.dangerIntent-Error, destructive, or critical.
.successIntent-Confirmation or completion.
.smSize-Small.
.mdSizeYesMedium.
.lgSize-Large.
.animatedMotionYesHonors the animations option.
.stillMotion-Forces motion off regardless of the option.

Examples​

Determinate​

Bar that fills to a given percentage.

Indeterminate​

Animated bar for operations without a known duration.

Accessibility​

  • WCAG 2.2 AA
  • Determinate progress is exposed to assistive technology with min, max, and current values
  • Indeterminate progress omits the current value so assistive technology announces the "busy, unknown duration" state
  • loading - indeterminate spinner for area-level loading states
  • steps - stepped indicator for ordered named stages