role progressbar
Progress bar draft v0.1.0
Shows how far a task has progressed, or that it is in progress when its length is unknown.
A progress bar fills a track from start to end as a task advances: an upload, an export, the steps of a setup. It has a visible label naming the task and, when the progress can be measured, an optional value in percent. When the length is unknown, the bar is indeterminate: a segment moves along the track to say that something is happening. It only reports: a progress bar is never a control.
Playground
Token inspector
Part container
Not rendered in this configuration.
-
gap from default
{space.4}Details
- Value
-
4px - CSS
--progress-bar-container-gap- Token
progress-bar.container.gap
-
column-gap from default
{space.8}Details
- Value
-
8px - CSS
--progress-bar-container-column-gap- Token
progress-bar.container.column-gap
Part label
Not rendered in this configuration.
-
color from default
{global.text.on-base.neutral.primary}Details
- Resolves through
light-switch.base.950 rawneutral.light.ash.950 raw- Value
-
#0E0D0Ddark:#D2CECF - CSS
--progress-bar-label-color- Token
progress-bar.label.color- Decisions
-
typography from default
Details
- Value
-
Inter [object Object]/1.5 500 [object Object] - CSS
--progress-bar-label-typography-font-family- Token
progress-bar.label.typography- Decisions
Part value
Not rendered in this configuration.
-
color from default
{global.text.on-base.neutral.secondary}Details
- Resolves through
light-switch.base.800 rawneutral.light.ash.800 raw- Value
-
#323031dark:#B9B7B7 - CSS
--progress-bar-value-color- Token
progress-bar.value.color- Decisions
-
typography from default
Details
- Value
-
Inter [object Object]/1.5 400 [object Object] - CSS
--progress-bar-value-typography-font-family- Token
progress-bar.value.typography- Decisions
Part track
Not rendered in this configuration.
-
height
smallfrom default{space.4}Details
- Value
-
4px - CSS
--progress-bar-track-height-small- Token
progress-bar.track.height.small- Decisions
-
height
mediumfrom default{space.8}Details
- Value
-
8px - CSS
--progress-bar-track-height-medium- Token
progress-bar.track.height.medium- Decisions
-
border-radius from default
{corner-radius.full}Details
- Value
-
9999px - CSS
--progress-bar-track-border-radius- Token
progress-bar.track.border-radius- Decisions
-
background from default
{global.bg.base.neutral.3}Details
- Resolves through
light-switch.base.100 rawneutral.light.ash.100 raw- Value
-
#ECE8E9dark:#282828 - CSS
--progress-bar-track-background- Token
progress-bar.track.background- Decisions
Part indicator
Not rendered in this configuration.
-
background from default
{global.bg.accent.brand.default}Details
- Resolves through
brand.light.600 raw- Value
-
#175DD6dark:#9EE7FA - CSS
--progress-bar-indicator-background- Token
progress-bar.indicator.background- Decisions
-
border-radius from default
{corner-radius.full}Details
- Value
-
9999px - CSS
--progress-bar-indicator-border-radius- Token
progress-bar.indicator.border-radius- Decisions
-
transition.duration from default
{duration.normal}Details
- Value
-
250ms - CSS
--progress-bar-indicator-transition-duration- Token
progress-bar.indicator.transition.duration- Decisions
-
transition.easing from default
{easing.standard}Details
- Value
-
cubic-bezier(0.2, 0, 0, 1) - CSS
--progress-bar-indicator-transition-easing- Token
progress-bar.indicator.transition.easing- Decisions
<div class="ds-progress-bar" data-size="medium">
<div class="ds-progress-bar__header">
<label
class="ds-progress-bar__label"
data-part="label"
for="ds-progress-bar-11"
>Uploading 12 photos</label>
</div>
<progress
class="ds-progress-bar__track"
data-part="track"
id="ds-progress-bar-11"
max="100"
value="40"
>40%</progress>
</div>