Skip to contentKino
Skip to Content

Progress

How far a task has got. The fill draws along a thin track, a sheen runs over it while it works, a piece slides across while the length is unknown, and the value turns into a tick when it is done.

npx shadcn add https://kinoui.com/r/progress.json
Share on

Examples

Import from Linear

Ledger web app · 1,284 issues in 36 projects
Ready to import 1,284 issues
x

Labels, cycles and comments come too.

Default

Put a ProgressLabel and a ProgressValue inside, and they sit in a row above the track. While it runs, a sheen sweeps the fill; once done, the value turns into a tick.

Export customer requests

Customer requests · 214 rows, 12 columns
Ready to export
x

Indeterminate

Give null while nobody knows how long it takes, and a piece slides across. Give a number once you know, and the fill draws in. completeLabel names what it says when done.

Attachments

Q3 planning · shared with Design and Product

Q3 roadmap.pdf

x

2.4 MB · waiting

Customer interviews, round 2.mp4

x

184 MB · waiting

Design review – Ledger web app, onboarding and billing flows.fig

x

38.0 MB · waiting

Brand photos.zip

x

512 MB · waiting

4 files · 736 MB

No visible label

Leave out the children and name it with aria-label, for a row that already shows its name. variant="destructive" marks a task that failed; say so in words beside it.

Installation

npx shadcn@latest add https://kinoui.com/r/progress.json
Files
lib/reduce-motion.tslib/track.tscomponents/kino/progress.tsx
Packages
@base-ui/react

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

Progress

PropTypeDefaultDescription
valuenumbernullNoneHow far it has got. null while the length is unknown.
minnumber0Where it starts.
maxnumber100Where it is complete.
variant"default""destructive""default"Destructive for a task that failed: the fill turns red and stops looking live.
formatIntl.NumberFormatOptionsNoneHow ProgressValue and the value read out are written. A percentage by default.
aria-labelstringNoneNames a progress that has no ProgressLabel.
getAriaValueText(formattedValue, value) => stringNoneWhat a screen reader reads for the value, such as "512 of 1,284".

ProgressValue

PropTypeDefaultDescription
completeLabelReactNode"Done"What it says beside a tick once the task is complete.

Data attributes

AttributeOnDescription
data-indeterminateProgressPresent while the value is null.
data-progressingProgressPresent while the value is known and below max.
data-completeProgressPresent once the value reaches max.
data-liveProgressPresent while it runs: started, below max and not failed. The sheen sweeps the fill.

CSS variables

VariableSet it onDefaultDescription
--progress-value-rollProgress, or <body>0.375remHow far the value rolls away as the tick takes its place.

Accessibility

  • It is a progressbar, named by ProgressLabel or by aria-label. Screen readers read the value as a percentage, or as getAriaValueText writes it.
  • The value and the tick in the row are for sighted users and are hidden from screen readers, which read the progress bar itself.
  • A failed task shows red: say it failed in text too, and in getAriaValueText, so the colour is never the only sign.
  • In forced colours the fill takes the system highlight and the track gets an outline.
  • When the system asks for less motion, the fill jumps to the value, the sheen is off, and while the length is unknown the whole track pulses instead of a piece sliding.