Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
FeedbackApple

Progress

Show normalized determinate progress with native accessibility semantics.

Public APILumenProgressApple / SwiftUISwift product: LumenUI

Apple availability

Supported native targets

Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.

iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple TV · tvOS 16+Apple Vision · visionOS 1+Apple Watch · watchOS 9+

Native example

Use Progress

Use only for determinate progress. Values are clamped into the valid range; invalid maximum values fall back to 100.

Progress rendered in the iPhone simulator Lumen playground
Verified runtime captureiPhone simulator
swift
LumenProgress(
    value: 72,
    label: "Profile completion"
)

Reference

Public API

The primary shared and platform-specific options exposed by LumenProgress.

APIValues or typeDefaultDescription
valueDouble0Provides the current determinate value.
maxDouble100Provides the positive maximum value.
labelString?nilNames the progress operation.
SwiftUI modifiersNative presentation APIAdjusts native layout or optional indicator color.

Native behavior

Design and accessibility

When to use it

Use only for determinate progress. Values are clamped into the valid range; invalid maximum values fall back to 100.

Accessibility

Progress exposes normalized minimum, maximum, and current values. Provide a label when surrounding text does not name the operation.

Shared component

Available on other platforms

React NativeAndroid / Compose
Apple docsSwiftUI package