Skip to main content
196

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
LayoutApple

Sheet

Present supplemental application content in a controlled native sheet.

Public APIlumenSheetApple / 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 Sheet

Use for supplemental editing or detail that should not replace the current screen. Keep form state and dismissal decisions application-owned.

Sheet rendered in the iPhone simulator Lumen playground
Captured exampleiPhone simulator
swift
content.lumenSheet(
    isPresented: $showEditor,
    title: "Edit report"
) {
    ReportEditor()
}

Reference

Public API

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

APIValues or typeDefaultDescription
dismissibleBooleantrueAllows platform gestures, back actions, and backdrop dismissal. Set false while application work requires the sheet to remain open.
scrollableBooleantrueScrolls content with reachable actions. Short windows and accessibility text sizes may scroll the complete sheet; set false for application-owned lazy or virtualized containers.
—RefObject<HostInstance | null>undefinedOptionally focuses an accessible application-owned control after presentation and restores its trigger after closing.
isPresentedBinding<Bool>RequiredControls native sheet presentation.
title / descriptionNative localized textnil / undefinedProvides optional heading context.
onDismiss() -> VoidRequiredReturns presentation ownership to the application.
content / actionsNative view slotsActions optionalComposes application-owned content and actions.

Native behavior

Design and accessibility

When to use it

Use for supplemental editing or detail that should not replace the current screen. Keep form state and dismissal decisions application-owned.

Accessibility

The native modal presentation contains focus while preserving the semantics and reading order of application-owned content.

Shared component

Available on other platforms

React NativeAndroid / Compose
Apple docsSwiftUI package