Progress

Determinate or indeterminate progress, as a linear bar or a circular ring.

62%

Import#

import { Progress } from "astralis-ui";

Circular#

62%
88%

Props#

PropTypeDefaultDescription
valuenumberCurrent progress. Omit entirely for indeterminate.
maxnumber100The value that counts as 100%.
shape"line" | "circle""line"Bar or ring.
size"sm" | "md" | "lg""md"Bar height / ring diameter.
colorSchemeall 11 schemes"brand"Hue of the filled portion.
showValueLabelbooleanfalsePercentage text (hidden while indeterminate).

Accessibility#

  • Renders role="progressbar" with aria-valuemin/max/now and a percentage aria-valuetext; indeterminate mode omits aria-valuenow, which is the standard ARIA signal for "busy, duration unknown".
  • Give each bar an accessible name (aria-label="Uploading photos") when more than one is on screen.