Progress
Overview
A Progress Bar is used to indicate how much progress a user has made in a workflow, expressed as a percentage (%). It provides visual feedback during multi-step or multi-phase processes and helps users understand how far they are from completion.
Progress Bars communicate status, not activity. They should not be used as loading indicators or pre-loaders. For page or system loading feedback, use the EnLoading component instead.
Guidelines
Dos
- Use Progress Bars for workflows with multiple steps or phases.
- Display progress as a clear percentage of completion.
- Update the Progress Bar as the user advances through the workflow.
- Use Progress Bars to set expectations and reduce user uncertainty.
- Ensure progress values are accurate and meaningful.
Don’ts
- Don’t use Progress Bars as page loaders or spinners.
- Don’t use Progress Bars for indeterminate or unknown durations.
- Don’t display a Progress Bar if there is no measurable progress.
- Don’t reset or regress progress unexpectedly without explanation.
- Don’t rely on color alone to convey progress state.
Variants
| Variant | Description | Example Use |
|---|---|---|
| Default | Standard progress indication | Multi-step forms, setup flows |
| Success | Indicates completion or positive progression | Final or completed steps |
| Mini | Thin meter with its count beside it | A completion tally over a list or picker |
Structure
Progress Bars should clearly represent completion from 0% to 100%.
- Always define
aria-valuemin,aria-valuemax, andaria-valuenow. - The width of the progress bar should directly reflect the percentage value.
- Progress text may be visually displayed or screen-reader–only.
Accessibility
Use appropriate ARIA attributes to communicate progress to assistive technologies.
- If visual text is hidden, include a screen-reader–only value.
- Ensure sufficient contrast between the progress bar and its background.
Example with screen-reader text:
Mini meter
progress-mini is a thin meter with its count beside the bar instead of inside it — "1 of 1 assigned" under a group list, "3 of 5 classes grouped" over a class picker. At 6px the bar can't carry its own text, so the count sits next to it.
It wraps an ordinary .progress / .progress-bar pair, so the context variants (progress-bar-success, progress-bar-warning) work as usual. The track is 120px by default — override it with any width-*px utility.
Use it where the count is the point and the bar is supporting; use the full-size bar for a workflow the user is moving through.
Related Components
EnLoading — Page and system loading indicators.