Component v1.1.0 Foundations

Progress Bar

Accessible determinate or indeterminate progress indicator.

API Stable 2.1 WCAG notes Ready Dark mode
Selector
ui-progress-bar
Package
@ngnova/ui/progress-bar

Import

Standalone Tailwind v4
import { UiProgressBarComponent } from '@ngnova/ui/progress-bar';

Usage & variants

Live examples use the public ui-progress-bar API, paired with the exact snippet a product team would paste into an Angular app.

API Reference

Build progress

Accessible determinate or indeterminate progress indicator.

Production guidance

Use these notes to decide when the component belongs in a product workflow and what to verify before shipping.

When to use

Use determinate progress when a value is known; use indeterminate when work has started but the percent is unknown.

Watch for

Values are clamped between 0 and max; a non-positive or non-finite max is normalized to 1.

Product recipes

Apply Progress Bar in distinct, copyable product scenarios—not just an isolated component state.

Build progress

Determinate progress exposes aria-valuenow and aria-valuemax.

Angular template ui-progress-bar-recipe.example.html
1
<ui-progress-bar [value]="buildPercent" [max]="100" label="Build progress" />

Storage quota

Pair progress with visible values so quota consumption remains understandable without color.

Angular template ui-progress-bar-recipe.example.html
1
2
3
4
5
6
7
<section aria-labelledby="storage-heading">
  <div class="flex justify-between">
    <h3 id="storage-heading">Storage</h3>
    <span>7.2 GB of 10 GB</span>
  </div>
  <ui-progress-bar [value]="72" ariaLabel="Storage used" />
</section>

API Reference

Inputs and outputs are semver-sensitive public API. Keep examples aligned with this table.

Inputs

value 0
number

Current progress value.

max 100
number

Maximum progress value.

label 'Progress'
string

Accessible progressbar label.

ariaValueText ''
string

Optional localized or human-readable determinate value text.

variant 'primary'
'primary' | 'success' | 'warning' | 'danger'

Semantic bar color.

indeterminate false
boolean

Removes value semantics when progress is unknown.

Accessibility

  • Uses role="progressbar" with a required accessible label.
  • Determinate mode exposes a normalized range and supports localized ariaValueText.
  • Indeterminate mode omits aria-valuemin, aria-valuemax, aria-valuenow, and aria-valuetext.

Keyboard behavior

  • Progress bars are read-only status indicators and do not receive focus.

Testing guidance

  • Assert normalized determinate ARIA values, visual width, and indeterminate omission.
  • No component harness is included because Progress Bar is a read-only status primitive with no interaction or hidden state.