Tally UI
Primitives

Progress

Displays a progress bar indicating completion of a task.

Import

import { Progress } from '@tallyui/primitives';

Usage

<Progress.Root value={75} max={100}>
  <Progress.Indicator />
</Progress.Root>

Components

Progress.Root

Container that holds the progress value and max.

PropTypeDefaultDescription
valuenumber | nullCurrent progress value, or null for indeterminate
maxnumber100Maximum value
getValueLabel(value: number, max: number) => stringCustom accessible label for the current value
asChildbooleanfalseMerge props onto child instead of rendering

Plus all React Native ViewProps.

Progress.Indicator

The filled portion of the bar. Style its width as a percentage of value / max.

PropTypeDefaultDescription
asChildbooleanfalseMerge props onto child instead of rendering

Plus all React Native ViewProps.

Accessibility

  • Role: progressbar
  • ARIA: aria-valuenow, aria-valuemin, aria-valuemax, aria-valuetext
  • When value is null, the bar is treated as indeterminate

On this page