Progress Bar
Accessible determinate or indeterminate progress indicator.
- Selector
- ui-progress-bar
- Package
- @ngnova/ui/progress-bar
Import
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.
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.
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.
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.
| Name | Type | Default | Description |
|---|---|---|---|
value | number | 0 | Current progress value. |
max | number | 100 | Maximum progress value. |
label | string | 'Progress' | Accessible progressbar label. |
ariaValueText | string | '' | Optional localized or human-readable determinate value text. |
variant | 'primary' | 'success' | 'warning' | 'danger' | 'primary' | Semantic bar color. |
indeterminate | boolean | false | 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.