Progress
Step completion — driven by the user
0 of 4 steps completed
Gamification and analytics — a value against a reference
7 of 10 achievements
82% profile complete
Circle — the same value as a ring
A role="progressbar" that represents a value against a reference —
completion of user-driven steps, gamification (achievements unlocked),
analytics. Determinate by design: the value advances because the user
acts, not because the system is working.
Progress is not multi-step navigation. A value that advances toward done is
progress; a sequence of named stages is a
Stepper; a short flow that only
needs to say where the user is takes plain contextual text such as Step 1 of 2. The Stepper page carries the
decision table for the three.
Two deliberate boundaries:
- No indeterminate state. A bar that sweeps or a ring that spins without a value is waiting — that is the Loading family’s job. For system-driven progress with time/percentage feedback (downloads, uploads, exports) use Loading Progress, which reuses this same anatomy.
- Progress vs Meter: they
look alike (a value in a range) and differ only in what they mean to
assistive tech.
progressbarsays “this advances toward done”;metersays “this is a level right now” (disk usage, battery, score) with optional low/high thresholds. If the value is heading to completion, Progress; if it is a snapshot measurement, Meter.
Import
Section titled “Import”<script> import Progress from "@invisible-ui/svelte/Progress.svelte";</script><script setup> import { Progress } from "@invisible-ui/vue";</script>import { Progress } from "@invisible-ui/react";<script type="module"> import "@invisible-ui/elements/define";</script>
<ds-progress></ds-progress>In Elements:
<ds-progress value="40" label="Upload progress"></ds-progress><ds-progress value="40" label="Exporting" shape="circle" show-value></ds-progress>| Prop | Type | Default | Description |
|---|---|---|---|
value | number | 0 | Completion (null = indeterminate). |
min | number | 0 | Range bounds. |
max | number | 100 | Range bounds. |
shape | "bar" | "circle" | "bar" | Shape: a linear bar (default) or a circle ring (upload/export). |
showValue | boolean | false | Show the percentage inside the circle (determinate circle only). |
label * | string | — | Accessible name. |
| Prop | Type | Default | Description |
|---|---|---|---|
value | number | 0 | Current value (determinate — see Loading for indeterminate waiting). |
min | number | 0 | Minimum value. |
max | number | 100 | Maximum value. |
shape | "bar" | "circle" | "bar" | Shape: a linear bar (default) or a circle ring (upload/export). |
showValue | boolean | false | Show the percentage inside the circle (determinate circle only). |
label * | string | — | Accessible name for the progress bar (required). |
| Prop | Type | Default | Description |
|---|---|---|---|
value | number | 0 | Current value. Progress is determinate; waiting with no value belongs to Loading. |
min | number | — | |
max | number | — | |
shape | "bar" | "circle" | "bar" | A linear bar (default) or a circle ring (an upload or an export). |
showValue | boolean | false | Show the percentage inside the circle. |
label * | string | — | Accessible name for the progress bar. |
| Attribute | Reactive | Description |
|---|---|---|
label * | yes | the accessible name |
value | yes | the current value; 0 by default |
min | yes | the range start; 0 by default |
max | yes | the range end; 100 by default |
shape | yes | bar|circle |
show-value | yes | the percentage inside the circle |
Reactive attributes re-render the element when they change after the first render.
Properties: value, min, max.
Accessibility
Section titled “Accessibility”role="progressbar"witharia-valuenow/min/max; the circle exposes the same semantics with the percentage optionally visible (showValue).
Example
Section titled “Example”<Progress value={7} max={10} label="Achievements unlocked" /><Progress shape="circle" value={82} showValue label="Profile completeness" />In React, useProgress gives the same props to markup of your own:
<Progress value={7} max={10} label="Achievements unlocked" /><Progress shape="circle" value={82} showValue label="Profile completeness" />Themeable via --ds-progress-*.