Loading Progress
Waiting with completion feedback: the system is working and the interface
reports how far along it is — a percentage, a byte count, a file count, an
expectation of when it ends. It reuses the
Progress anatomy (bar and
ring) and the bar variant of
Loading Spinners, adding the
label / value / detail line.
The split with Progress is about who drives the value: here the system does (downloads, uploads, exports, syncs) — the user waits. When the value advances because the user acts (steps completed, achievements), that is Progress, which lives under Data and is determinate by design.
Indeterminate waiting (a bar that sweeps, no value yet) belongs here too — the card examples in the demo show the indeterminate → determinate pair.
Import
Section titled “Import”<script> import Loading from "@invisible-ui/svelte/Loading.svelte"; import Progress from "@invisible-ui/svelte/Progress.svelte";</script><script setup> import { Loading, Progress } from "@invisible-ui/vue";</script>import { Loading, Progress } from "@invisible-ui/react";<script type="module"> import "@invisible-ui/elements/define";</script>
<ds-loading></ds-loading><ds-progress></ds-progress>Bar loaders are the bar variant of Loading:
| Prop | Type | Default | Description |
|---|---|---|---|
variant | "dots" | "spinner" | "bar" | "typing" | "morph" | "dots" | Indicator shape: pulsing dots or a rotating spinner arc. |
value | number | null | null | Completion percentage (0–100) for the bar variant: the bar becomes determinate (a fill that grows to done) and exposes progressbar semantics. Leave null for the indeterminate sliding segment. |
label | string | undefined | undefined | Accessible name announced by the status role. |
showLabel | boolean | false | Also render the label as visible text next to the indicator. |
showValue | boolean | false | Show the percentage (from value) as visible text. |
detail | string | undefined | undefined | Extra visible detail, e.g. "3 of 8 files" or "48 MB of 128 MB". |
decorative | boolean | false | Hide from assistive tech (the surrounding region announces the state). |
status | string | undefined | undefined | Live status message — a running description of what the process is doing ("Connecting…", "Fetching records…", "Rendering…"). Unlike label (a static accessible name), this renders as visible text **inside** the polite role="status" region and is announced on every change, so a succession of backend-reported steps is read out as it progresses. The region is aria-atomic, so each new message is announced in full. Ignored on a determinate bar (a progressbar announces its value, not free text) and when decorative. |
delay | number | 0 | No-flash delay (ms): keep the indicator hidden until this long has passed, so a fast operation never flashes a loader. If the component is removed before the delay elapses, nothing is ever shown. Follows the response-time rule — reveal a loader only once a wait is actually noticeable. Default 0 (shown immediately). |
overlay | boolean | false | Render as a centered overlay filling the nearest positioned ancestor — the built-in busy-region pattern. Mark that region aria-busy="true". |
veil | boolean | true | With overlay: paint a translucent backdrop that also blocks pointer interaction while busy. Set false to overlay just the indicator (no dim, no pointer blocking) — e.g. over a control whose own modal already guards interaction. |
| Prop | Type | Default | Description |
|---|---|---|---|
variant | LoadingVariant | "dots" | Indicator shape: pulsing dots, a rotating spinner arc, bouncing typing dots (chat "waiting for a reply"), a morphing shape (square ⇄ circle), or a bar (full-width track — place it at the top of the content it covers, e.g. a card). |
value | number | null | null | Completion percentage (0–100) for the bar variant: the bar becomes determinate (a fill that grows to done) and exposes progressbar semantics. Leave null for the indeterminate sliding segment. |
label | string | undefined | Accessible name. Defaults to the i18n catalog's "Loading…". |
showLabel | boolean | false | Also render the label as visible text next to the indicator. |
showValue | boolean | false | Show the percentage (from value) as visible text. |
detail | string | undefined | Extra visible detail, e.g. "3 of 8 files" or "48 MB of 128 MB". On a determinate bar it is also exposed as aria-valuetext. |
decorative | boolean | false | Hide from assistive tech (the surrounding region announces the state). |
status | string | undefined | Live status message — a running description of what the process is doing ("Connecting…", "Fetching records…", "Rendering…"). Unlike label (a static accessible name), this renders as visible text **inside** the polite role="status" region and is announced on every change, so a succession of backend-reported steps is read out as it progresses. The region is aria-atomic, so each new message is announced in full. On a determinate bar the text renders below the track and also feeds aria-valuetext when no detail is set (a progressbar announces its value text, not a live region). Ignored when decorative. |
delay | number | 0 | No-flash delay (ms): keep the indicator hidden until this long has passed, so a fast operation never flashes a loader. If the component is removed before the delay elapses, nothing is ever shown. Follows the response-time rule — reveal a loader only once a wait is actually noticeable. Default 0 (shown immediately). |
overlay | boolean | false | Render as a centered overlay filling the nearest positioned ancestor — the built-in busy-region pattern. Mark that region aria-busy="true". |
veil | boolean | true | With overlay: paint a translucent backdrop that also blocks pointer interaction while busy. Set false to overlay just the indicator (no dim, no pointer blocking) — e.g. over a control whose own modal already guards interaction. |
| Prop | Type | Default | Description |
|---|---|---|---|
variant | LoadingVariant | "dots" | Indicator shape: pulsing dots, a rotating spinner arc, bouncing typing dots (waiting for a chat reply), a morphing shape (square to circle), or a bar (a full-width track: place it at the top of the content it covers). For a whole surface that renders, use LoadingGenerationArea. |
value | number | null | null | Completion percentage (0 to 100) for the bar variant: the bar becomes determinate, a fill that grows to done, with progressbar semantics. Leave it null for the indeterminate sliding segment. |
label | string | — | Accessible name. Defaults to the catalog's "Loading…". |
showLabel | boolean | false | Also show the label as visible text next to the indicator. |
showValue | boolean | false | Show the percentage (from value) as visible text. |
detail | string | — | Extra visible detail, such as "3 of 8 files". On a determinate bar it is also the aria-valuetext. |
decorative | boolean | false | Hide from assistive technology (the surrounding region announces the state). |
status | string | — | Live status message: what the process is doing now ("Connecting…", "Fetching records…"). It shows as text inside the polite role="status" region and is announced in full on every change. On a determinate bar it shows below the track and is the aria-valuetext when no detail is set. Ignored when decorative. |
delay | number | 0 | No-flash delay in ms: the indicator stays hidden until this long has passed, so a fast operation never flashes a loader. Read once, when the component mounts. Default 0 (shown at once). |
overlay | boolean | false | Render as a centred overlay over the nearest positioned ancestor. Mark that region aria-busy="true". |
veil | boolean | true | With overlay: a translucent backdrop that also blocks the pointer while busy. Set false to overlay the indicator alone. |
| Attribute | Reactive | Description |
|---|---|---|
variant | yes | |
value | yes | |
label | yes | |
show-label | yes | |
show-value | yes | |
detail | yes | |
decorative | yes | |
status | yes | |
delay | yes | |
overlay | yes | |
veil | yes |
Reactive attributes re-render the element when they change after the first render.
Accessibility
Section titled “Accessibility”- Determinate bars are
progressbars witharia-value*; the value is announced viaaria-valuetextas it changes. - The indeterminate bar announces as busy without a value — use it only until a value is known, then switch to the determinate form.
- Per the response-time guidance:
past ~10 s the user needs a determinate bar with a percentage or
detail, and ideally a way to cancel.
Example
Section titled “Example”<Loading variant="bar" value={percent} showLabel showValue label="Downloading" /><Progress shape="circle" value={percent} showValue label="Uploading photo" />