Progress

Native determinate or indeterminate progress with a label and a text readout.

Advance a demo job by 25 units on the server, or reset it.

Open in new tab

Each preview is its own Live page in a frame, because this site is a Vue 3.5 app built on the Pulsar starter kit. An open list or popover stays inside its frame; in your application it opens over the page.

Installation

bash
suprnova live:add progress

Usage

html
{% import "suprnova-ui/progress/progress.html" as progress %}
{% call progress::progress("report", "Preparing report", value=completed) %}{% endcall %}

Examples

Unknown total

Prepare a demo report with simulated latency and show activity while the server works.

Open in new tab

Keyboard and accessibility

suprnova.progress - determinate or indeterminate progress on the native progress element (FDB-006). Determinate work carries max and value; indeterminate work carries max only, which the browser renders as activity. The label names the work and the readout states completion in text, so color never carries the meaning alone.

API reference

progress

ParameterDefaultDescription
idRequiredThe native progress element's unique id, associated with its label.
labelRequiredThe name of the work in progress.
value0Completed work, rendered only when determinate is true.
max100The total work, greater than zero.
determinatetrueWhether the total is known; false omits the native value attribute.