AurumProgressBar
Aurum's linear progress bar — a determinate 8 pt track with a primary-fill indicator.
| family | Feedback |
|---|---|
| platform | iOS 17+ · SwiftUI |
| figma | component master ↗ |
| source | Sources/Aurum/Component/Feedback/AurumProgressBar.swift |
| code connect | FigmaConnect/Sources/AurumFigmaConnect/AurumProgressBar.figma.swift |
Aurum's linear progress bar — a determinate 8 pt track with a
primary-fill indicator. The SwiftUI port of aurum-android's
AurumProgressBar: an 8 pt pill track (interactive.bgNeutralDefault)
with a primary indicator sized to progress, plus an optional header
row (leading label, trailing percentage).
Determinate only — for an indeterminate spinner use AurumLoader.
Intended use
A determinate progress indicator for a known, bounded task — onboarding steps, upload/download, a multi-stage flow. Drive progress from your state (0...1). For unknown-duration waits use AurumLoader; for stepped/story progress use AurumSegmentedProgressBar.
Do
- Pass a
0...1fraction; values are clamped into range. - Animate at the call site (
withAnimation) when progress jumps, so the fill glides. - Use
label:+showPercentage:to give the bar context in a header row.
Don’t
- Use it for indeterminate / unknown-duration work — that's
AurumLoader. - Recolour the track/indicator — the tokens are fixed (neutral track, primary fill).
Code Connect
Mapped to Figma node 5934:846 ↗ — SwiftUI snippets appear in Dev Mode for the latest release.