Skip to content

Progress and meter

Progress shows task completion; Meter shows a measurement against its range and limit.

npx dtheo@latest add progress

Progress: work getting done

Uploading R-0412 traces
x
Computing efficiency map
x

Meter: a measurement against its limit

Winding temperature
x
Phase current
x

Near the 40 A limit

When to use

  • Upload or analysis progress
  • Load, temperature or current against a limit
  • Waits under ~300 ms: show nothing
  • Unknown duration presented as a percentage: pass value={null}

API

value
Progress: null for indeterminate work. Never fake a percentage.number | null
limit
Meter: draws a tick at the limit.number
tone= 'primary'
Meter: fill severity. Pair it with a word or icon.neutralprimarysuccesswarningdestructive
unit
Shown after the value when showValue is on, for units Intl cannot format (A, N·m).string

Other props pass through to Base UI’s Progress, Meter.

Accessibility

  • Indeterminate progress (value={null}) is honest when the duration is unknown; never fake a percentage.

Used in