Components › States & feedback › Loading › Progress

Progress

canon

The one canonical progress bar: work that takes minutes — the step in words, an optional number, time left, optional steps; running, done or failed.

Product owner 25 Sep 2026 (FA202): approved as THE one progress bar, 6 px (--sp-2) like .tl-prog instead of the 4 px candidate; the product-extraction bar (.pr-ex) was migrated onto it in acrm !3883, the other scattered bars were inventoried on 26 Sep 2026 (wave B): static ratios moved to Meter (acrm !3898, !3900), .tf-progress/.tf-subs-bar were dead CSS and removed (acrm !3901), .tl-prog in Task list turned out to be dead API and was deleted (acrm !3947). Estimates are written in words ("asi 23 %").

Used in 5 files · 4 areas · 5× — components/mail, components/meetings, components/running, pages/ProduktDetailPage

Import

import { Progress } from '@acrm/ui'

Props

Progress packages/ui/src/components/Progress.tsx

NameTypeDefaultDescription
label *ReactNode—Co právě běží — krok slovy („Oprava jmen"), ne obecné „Zpracovává se".
valuenumber | null—Hodnota 0–100. Chybí (nebo null) = neurčitý průběh: úsek běží po dráze.
valueTextstring—Co se ukáže vpravo od kroku: měřené „61 %", odhad „asi 23 %" (AD 25. 9. 2026: slovem, ne vlnovkou). Bez něj se číslo nekreslí — hodnota, kterou nejde poctivě vyjádřit v procentech (např. syntetická šířka proužku), se uživateli neukazuje.
metaReactNode—Řádek pod proužkem — zbývající čas, co se děje, u selhání důvod.
stepsProgressStep[]—Volitelný výčet kroků (hotovo · běží · čeká).
tone'run' | 'done' | 'failed''run'Stav práce: run (výchozí, akcent) · done (zelená) · failed (kritická, meta nese důvod). Koncové stavy převzaté z průběhu extrakce produktu (.pr-ex), který Progress nahradil — kánon nahrazuje, nedoplňuje.
ariaLabel *string—Název procesu pro čtečku („Zpracování přepisu").
classNamestring——

CSS classes

.acrm-progress.pg-head.pg-label.pg-val.pg-track.pg-fill.pg-meta.pg-steps.pg-step.pg-ic.pg-sl.pg-sd

Files