Skip to content
Storybook

Progress bar

Determinate progress for uploads and onboarding. Fill grows from the inline start.

40%
100%
72%

Usage

  • Use a Spinner for unknown waits.

Installation

Included in the core files. No extra install.

HTML
<link rel="stylesheet" href="/css/pixels-tokens.css">
<link rel="stylesheet" href="/css/pixels-ui.css">
<script src="/js/pixels-ui.js" defer></script>

API reference

Class / attributeTypeDescription
px-progress · --success · --danger · --bottomclassTone and label position.
--vCSS varFill value, e.g. style="--v:40%".

Figma properties

Progress bar18 variants · page “Progress Bar”Open

Determinate progress (uploads, onboarding steps). Fill width = value %; in RTL the fill grows from the right. role=progressbar with aria-valuenow. Use Spinner for indeterminate waits.

PropertyTypeValues
Value labelText“40%”
LabelVariantNone Right Bottom
ToneVariantBrand Success Danger
DirectionVariantLTR RTL

Design tokens

Component tokens from the Figma Component collection. Override them to restyle just this component.

TokenAliasLight value
--px-progress-trackcolor-surface-sunken#f9fafb
--px-progress-fillcolor-background-brand-default#2563eb
--px-progress-height8px8px
--px-progress-radiusradius-full999px
--px-progress-labelcolor-content-neutral-primary#101828

Accessibility

  • role="progressbar" with aria-valuenow.