Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
NavigationApple

Tab accessory

Adapt application-owned accessory content to expanded and inline tab-bar placement.

Public APILumenTabAccessoryApple / 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 accessory

Use for a mini player, call, upload, recording, or persistent status. Keep accessory domain state and actions application-owned.

Tab accessory rendered in the iPhone simulator Lumen playground
Verified runtime captureiPhone simulator
swift
TabView {
    FeedView().tabItem { Label("Feed", systemImage: "rectangle.stack") }
}
.lumenTabViewBottomAccessory {
    LumenTabAccessory {
        ExpandedUploadStatus()
    } compact: {
        CompactUploadStatus()
    }
}

Reference

Public API

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

APIValues or typeDefaultDescription
expanded@ViewBuilder () -> ViewRequiredProvides content displayed above a regular-size tab bar.
compact@ViewBuilder () -> ViewRequiredProvides reduced content displayed inline with a minimized tab bar.
isEnabledBooltrueControls whether the surrounding tab accessory modifier presents content.

Native behavior

Design and accessibility

When to use it

Use for a mini player, call, upload, recording, or persistent status. Keep accessory domain state and actions application-owned.

Accessibility

Expanded and compact content preserve their own readable labels, controls, and traversal order while SwiftUI owns placement changes.

Apple docsSwiftUI package