Progress Bar
Linear progress indicator with determinate and indeterminate modes, sizes, color variants, and an optional label and percentage.
Preview
<ProgressBar value={68} label="Uploading" showValue={true} /> Variants
<ProgressBar value={60} variant="primary" />
<ProgressBar value={60} variant="success" />
<ProgressBar value={60} variant="warning" />
<ProgressBar value={60} variant="danger" /> Sizes
<ProgressBar value={50} size="xs" />
<ProgressBar value={50} size="sm" />
<ProgressBar value={50} size="md" />
<ProgressBar value={50} size="lg" /> Label & indeterminate
Add a label (and showValue for the percentage) above the track. Indeterminate mode runs a looping translate animation when the completion is unknown.
<ProgressBar value={40} label="Processing" showValue={true} variant="warning" />
<ProgressBar mode="indeterminate" label="Loading…" /> API
| Prop | Type | Default | Description |
|---|---|---|---|
value | number | 0 | Progress, clamped to 0–100. Ignored in indeterminate mode. |
mode | 'determinate' | 'indeterminate' | 'determinate' | Determinate fill vs a looping indeterminate animation. |
size | 'xs' | 'sm' | 'md' | 'lg' | 'md' | Track height (2 / 4 / 8 / 12px). |
variant | 'primary' | 'success' | 'warning' | 'danger' | 'primary' | Fill color intent. |
label | string | '' | Optional text shown above the track; also used as the accessible label. |
showValue | boolean | true | Shows the percentage next to the label (determinate only). |
Accessibility
- Renders
role="progressbar"witharia-valuemin="0"andaria-valuemax="100". aria-valuenowis set in determinate mode and omitted while indeterminate.aria-labelfalls back to "Progress" when nolabelis provided.
Theming surface
Every public token this component reads, extracted from its source at build time,
split by blast radius: the hooks that belong to this component,
then the shared and system tokens it consumes alongside everything else. The
Resolves to column walks each token's real lineage —
component → semantic → primitive → raw value — so you
can see exactly where re-pointing it lands. A spoke re-skins by overriding these in
its theme-<slug>.css; component internals are never edited. No
hook for what you need? File it with /request-lego.
Type roles it names
This component does not set a size, weight, face or tracking of its own — it names a composite, and the composite carries all five. A composite is a class rather than a token, so none of it appears in the tables below; re-theme text by re-pointing the token family, not by editing the component.
| Role | Re-point | Reach |
|---|---|---|
.typography-body-2xs |
| +6 more componentsesa-checkbox, esa-checkbox-group, esa-combobox, esa-input-tag, esa-radio-group, esa-textarea |
.typography-body-md |
| +28 more componentsesa-app-shell, esa-breadcrumbs, esa-card, esa-checkbox, esa-checkbox-group, esa-collapsible, esa-combobox, esa-command-palette, esa-confirm-dialog, esa-container, esa-danger-zone, esa-dialog, esa-dropdown-menu, esa-empty-state, esa-entity-search, esa-form-field, esa-header-nav, esa-input-tag, esa-nav-dropdown, esa-page-header, esa-popover, esa-radio-group, esa-select, esa-side-dialog, esa-snackbar-item, esa-switch-toggle, esa-tab-layout, esa-textarea |
.typography-body-sm |
| +20 more componentsesa-alert-box, esa-breadcrumbs, esa-button-toggle, esa-card, esa-checkbox-group, esa-combobox, esa-command-palette, esa-date-picker, esa-empty-state, esa-file-upload, esa-form-field, esa-input-tag, esa-link-column, esa-loading-overlay, esa-radio-group, esa-search-panel, esa-select, esa-stat, esa-text-field, esa-textarea |
.typography-body-xs |
| +14 more componentsesa-breadcrumbs, esa-checkbox, esa-checkbox-group, esa-combobox, esa-command-palette, esa-empty-state, esa-entity-search, esa-field-error, esa-header-nav, esa-input-tag, esa-radio-group, esa-search-panel, esa-select, esa-textarea |
.typography-label-2xs |
| +11 more componentsesa-button-toggle, esa-checkbox-group, esa-color-picker, esa-combobox, esa-date-picker, esa-form-field, esa-input-tag, esa-radio-group, esa-range-slider, esa-text-field, esa-textarea |
.typography-label-md |
| +33 more componentsesa-app-bar, esa-breadcrumbs, esa-button-group, esa-button-toggle, esa-card, esa-checkbox-group, esa-color-picker, esa-combobox, esa-command-palette, esa-confirm-dialog, esa-danger-zone, esa-date-picker, esa-dialog, esa-empty-state, esa-entity-search, esa-file-upload, esa-filter-container, esa-form-field, esa-header-nav, esa-input-tag, esa-link-column, esa-page-header, esa-pillbox, esa-popover, esa-radio-group, esa-range-slider, esa-select, esa-side-dialog, esa-sidebar-nav, esa-stat, esa-text-field, esa-textarea, esa-tooltip |
.typography-label-sm |
| +3 more componentsesa-breadcrumbs, esa-search-panel, esa-sidebar-nav |
.typography-label-xs |
| +14 more componentsesa-breadcrumbs, esa-button-toggle, esa-checkbox-group, esa-color-picker, esa-combobox, esa-date-picker, esa-entity-search, esa-form-field, esa-input-tag, esa-radio-group, esa-range-slider, esa-select, esa-text-field, esa-textarea |
Wired to this component
No other component reads these — re-point them and esa-progress-bar is the
only thing that moves.
| Token | Tier | Resolves to |
|---|---|---|
--progress-bar-height-lg | component | 12px |
--progress-bar-height-md | component | 8px |
--progress-bar-height-sm | component | 4px |
--progress-bar-height-xs | component | 2px |
Shared tokens it reads
Owned by a family or by the semantic layer. Still overridable — but scope the
override (esa-foo { --form-border-color: … }) unless you mean to move
everything that reads it. Reach says what else that is.
| Token | Reach | Resolves to |
|---|---|---|
--animation-indeterminate | semantic every component | 1500ms via --duration-1500 |
--color-background-brand | semantic every component | #46a758 via --color-grass-9 |
--color-background-elevation-sunken | semantic every component | #f0f0f0 via --color-gray-3 |
--color-background-utility-danger | semantic every component | #ce2c31 via --color-red-11 |
--color-background-utility-success | semantic every component | #218358 via --color-green-11 |
--color-background-utility-warning | semantic every component | #ffc53d via --color-yellow-9 |
--color-content-default | semantic every component | #202020 via --color-gray-12 |
--color-content-default-secondary | semantic every component | #646464 via --color-gray-11 |
--radius-pill | semantic every component | 9999px via --radius-full |
--spacing-100 | primitive every component | 0.25rem |