Skip to content

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

68%
0%

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. progressbar says “this advances toward done”; meter says “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.
<script>
import Progress from "@invisible-ui/svelte/Progress.svelte";
</script>

In Elements:

<ds-progress value="40" label="Upload progress"></ds-progress>
<ds-progress value="40" label="Exporting" shape="circle" show-value></ds-progress>
PropTypeDefaultDescription
valuenumber0Completion (null = indeterminate).
minnumber0Range bounds.
maxnumber100Range bounds.
shape"bar" | "circle""bar"Shape: a linear bar (default) or a circle ring (upload/export).
showValuebooleanfalseShow the percentage inside the circle (determinate circle only).
label *string—Accessible name.
  • role="progressbar" with aria-valuenow/min/max; the circle exposes the same semantics with the percentage optionally visible (showValue).
<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-*.