Skip to content
uiify

Progress

Native progress element for determinate or indeterminate work.

Browsers
Chrome 123+Firefox 121+Safari 17.5+
Tier
0
Bundle compressed
93 B
Forced layout budget
0 ms
Axe budget
0
SSR compatible
Yes
Published contract
Test harness

Playground

Progress

Examples

Indeterminate work

Omit value when the amount of completed work is unknown.

import { Progress } from "@gunkin/uiify";

export default function Example() {
  return (
    <>
      <label htmlFor="file-progress">Preparing files</label>
      <Progress id="file-progress" />
    </>
  );
}

API

Progress

PropTypeDefaultDescription
valuenumber—Current progress value; omit it for indeterminate progress.
maxnumber1Maximum progress value accepted by the native element.
Accessible name*native <label> / aria-label / aria-labelledby—Provide an accessible name with aria-label, aria-labelledby, or a native label.
classNamestring—Class applied to the native progress element.
styleCSSProperties—Native progress element styles.
refRef<HTMLProgressElement>—Ref forwarded to the native progress element.

Keyboard

KeyAction

Accessibility

Native progress element. Associate a label or accessible name; omitting value exposes indeterminate progress. Browser rendering varies, and UIify does not simulate updates or announce them.

Styling hooks

data-uiify-progress