NavigationApple

Tab bar minimization

Let an iPhone native tab bar minimize and expand in response to scrolling.

Public APIlumenTabBarMinimizeBehaviorApple / 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+

Native example

Use Tab bar minimization

Apply to a native TabView. iOS 26 uses system minimization on iPhone; earlier supported releases retain the normal tab bar without a custom imitation.

Tab bar minimization rendered in the iPhone simulator Lumen playground — Verified runtime captureiPhone simulator

TabView(selection: $selection) {
    FeedView().tabItem { Label("Feed", systemImage: "rectangle.stack") }
    ProfileView().tabItem { Label("Profile", systemImage: "person") }
}
.lumenTabBarMinimizeBehavior(.onScrollDown)

Reference

Public API

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

API	Values or type	Default	Description
behavior	`automatic · never · onScrollDown · onScrollUp`	`Required`	Selects the native minimization policy.
availability	`iOS 16 or newer`	`Required`	Uses native minimization on iOS 26 and a no-op compatibility fallback before iOS 26.

Native behavior

Design and accessibility

When to use it

Apply to a native TabView. iOS 26 uses system minimization on iPhone; earlier supported releases retain the normal tab bar without a custom imitation.

Accessibility

SwiftUI retains native tab focus, safe-area adjustment, animation, and reduced-motion behavior while the application owns selection and navigation state.