Progress

A native progress indicator for measured or unknown completion.

Interactive preview

Live specimenTry the component

Installation

Add editable source to an initialized React project. Set up antiflex/ui first if you are new here.

Terminal
npx antiflex-ui@0.1.0-alpha.2 add progress

This site previews the latest workspace styles and motion. The published alpha keeps its released styles until the next npm release.

Usage

React
<Progress value={64} max={100} aria-label="Importing records" />
<Progress aria-label="Preparing files" />

API reference

All components forward native attributes, className, and refs to their underlying elements.

PropTypeDefault
valuenumber | undefinedundefined (indeterminate)
maxnumber100
sizesm | md | lgmd

Accessibility

Provide aria-label, aria-labelledby, or an associated native Label. A missing/non-finite value is indeterminate. Finite values clamp between zero and max; invalid max falls back to 100. Native progress semantics expose the measured value. Progress is not a live region; announce meaningful milestones separately and use aria-busy on the region being updated. Reduced motion stops indeterminate animation. Ref targets HTMLProgressElement.