Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
ActionsApple

Menu

Present a native anchored action menu with shared item-state semantics.

Public APILumenMenuApple / 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 Vision · visionOS 1+Apple TV · tvOS 17+

Native example

Use Menu

Use for a short set of contextual actions. Keep labels unique and concise, and do not hide a screen's only primary action inside a menu.

Menu rendered in the iPhone simulator Lumen playground
Verified runtime captureiPhone simulator
swift
LumenMenu(items: actions) {
    Label("More", systemImage: "ellipsis")
}

Reference

Public API

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

APIValues or typeDefaultDescription
itemsNative Lumen menu item collectionRequiredProvides labeled actions and states.
Native Menu stateNativeCollapsedControls or reports native menu presentation.
disabledBooleanfalseKeeps an unavailable item readable but inactive.
destructive / roleDestructive action rolefalse / nilMarks a destructive action semantically and visually.

Native behavior

Design and accessibility

When to use it

Use for a short set of contextual actions. Keep labels unique and concise, and do not hide a screen's only primary action inside a menu.

Accessibility

The trigger exposes expanded state and each native menu action reports its label, disabled state, and destructive role.

Shared component

Available on other platforms

React NativeAndroid / Compose
Apple docsSwiftUI package