When to use it
Use for a small set of peer app destinations. Keep hierarchical navigation, history, deep links, restoration, and screen rendering in the application router or native navigation stack.
NavigationApple
Navigation bar
Select among peer application destinations with native visuals and controlled state.
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 Navigation bar
Use for a small set of peer app destinations. Keep hierarchical navigation, history, deep links, restoration, and screen rendering in the application router or native navigation stack.
LumenNavigationBar(
selection: $destination,
items: destinations,
onReselect: scrollDestinationToTop
)Reference
Public API
The primary shared and platform-specific options exposed by LumenNavigationBar.
| API | Values or type | Default | Description |
|---|---|---|---|
| items | [LumenNavigationItem<Selection>] | Required | Provides destination values, short labels, native icons, disabled state, and optional dot, text, or capped count badges. |
| selection | Binding<Selection> | Required | Stores the active destination. |
| onValueChange | Binding setter | Required | Requests a destination change without owning navigation history. |
| onReselect | ((Selection) -> Void)? | nil | Handles a second activation of the selected destination, such as scrolling to top or popping its stack. |
| label | String | Primary navigation | Names the destination group for assistive technology. |
Native behavior
Design and accessibility
Accessibility
The group has a readable navigation label and every destination exposes selected and disabled state through native tab semantics.
Shared component