Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
FeedbackApple

Status bar

Present compact textual application status with optional trailing content.

Public APILumenStatusBarApple / 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 Status bar

Use for compact persistent application status. Do not replace system status bars or navigation chrome.

Status bar rendered in the iPhone simulator Lumen playground
Verified runtime captureiPhone simulator
swift
LumenStatusBar("All changes saved", tone: .success) {
    Text("Just now")
}

Reference

Public API

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

APIValues or typeDefaultDescription
messageLocalizedStringKeyRequiredProvides the textual status.
toneneutral · brand · accent · success · warning · dangerneutralSelects the semantic dot color.
trailing@ViewBuilder () -> TrailingEmptyViewProvides optional trailing content.

Native behavior

Design and accessibility

When to use it

Use for compact persistent application status. Do not replace system status bars or navigation chrome.

Accessibility

The visible status dot is decorative; the message carries status meaning in text. Trailing controls retain independent semantics.

Shared component

Available on other platforms

React NativeAndroid / Compose
Apple docsSwiftUI package