Presentation Modifiers

Define additional views for the view to present under specified conditions. 追加のビューをビューに対して定義して、指定された条件の下で提示します。

Overview 概要

Use presentation modifiers to show different kinds of modal presentations, like alerts, popovers, sheets, and confirmation dialogs.

Because SwiftUI is a declarative framework, you don’t call a method at the moment you want to present the modal. Rather, you define how the presentation looks and the condition under which SwiftUI should present it. SwiftUI then detects when the condition changes and makes the presentation for you. Because you provide a Binding to the condition that initiates the presentation, SwiftUI can reset the underlying value when the user dismisses the presentation.

To learn how to create the structure that enables users to navigate among the parts of your app, see Presentation Containers.

Topics 話題

Alerts

func alert<S, A>(S, isPresented: Binding<Bool>, actions: () -> A) -> some View
Presents an alert when a given condition is true, using a string variable as a title.
func alert<A>(Text, isPresented: Binding<Bool>, actions: () -> A) -> some View
Presents an alert when a given condition is true, using a text view for the title.
func alert<A>(LocalizedStringKey, isPresented: Binding<Bool>, actions: () -> A) -> some View
Presents an alert when a given condition is true, using a localized string key for the title.
func alert<A, T>(Text, isPresented: Binding<Bool>, presenting: T?, actions: (T) -> A) -> some View
Presents an alert using the given data to produce the alert’s content and a text view as a title.
func alert<A, T>(LocalizedStringKey, isPresented: Binding<Bool>, presenting: T?, actions: (T) -> A) -> some View
Presents an alert using the given data to produce the alert’s content and a localized string key for a title.
func alert<S, A, T>(S, isPresented: Binding<Bool>, presenting: T?, actions: (T) -> A) -> some View
Presents an alert using the given data to produce the alert’s content and a string variable as a title.
func alert<E, A>(isPresented: Binding<Bool>, error: E?, actions: () -> A) -> some View
Presents an alert when an error is present.

Alerts with a Message

func alert<S, A, M>(S, isPresented: Binding<Bool>, actions: () -> A, message: () -> M) -> some View
Presents an alert with a message when a given condition is true using a string variable as a title.
func alert<A, M>(LocalizedStringKey, isPresented: Binding<Bool>, actions: () -> A, message: () -> M) -> some View
Presents an alert with a message when a given condition is true, using a localized string key for a title.
func alert<A, M>(Text, isPresented: Binding<Bool>, actions: () -> A, message: () -> M) -> some View
Presents an alert with a message when a given condition is true using a text view as a title.
func alert<A, M, T>(LocalizedStringKey, isPresented: Binding<Bool>, presenting: T?, actions: (T) -> A, message: (T) -> M) -> some View
Presents an alert with a message using the given data to produce the alert’s content and a localized string key for a title.
func alert<A, M, T>(Text, isPresented: Binding<Bool>, presenting: T?, actions: (T) -> A, message: (T) -> M) -> some View
Presents an alert with a message using the given data to produce the alert’s content and a text view for a title.
func alert<S, A, M, T>(S, isPresented: Binding<Bool>, presenting: T?, actions: (T) -> A, message: (T) -> M) -> some View
Presents an alert with a message using the given data to produce the alert’s content and a string variable as a title.
func alert<E, A, M>(isPresented: Binding<Bool>, error: E?, actions: (E) -> A, message: (E) -> M) -> some View
Presents an alert with a message when an error is present.

Confirmation Dialogs

func confirmationDialog<S, A>(S, isPresented: Binding<Bool>, titleVisibility: Visibility, actions: () -> A) -> some View
Presents a confirmation dialog when a given condition is true, using a string variable as a title.
func confirmationDialog<A>(Text, isPresented: Binding<Bool>, titleVisibility: Visibility, actions: () -> A) -> some View
Presents a confirmation dialog when a given condition is true, using a text view for the title.
func confirmationDialog<A>(LocalizedStringKey, isPresented: Binding<Bool>, titleVisibility: Visibility, actions: () -> A) -> some View
Presents a confirmation dialog when a given condition is true, using a localized string key for the title.
func confirmationDialog<A, T>(Text, isPresented: Binding<Bool>, titleVisibility: Visibility, presenting: T?, actions: (T) -> A) -> some View
Presents a confirmation dialog using data to produce the dialog’s content and a text view for the title.
func confirmationDialog<A, T>(LocalizedStringKey, isPresented: Binding<Bool>, titleVisibility: Visibility, presenting: T?, actions: (T) -> A) -> some View
Presents a confirmation dialog using data to produce the dialog’s content and a localized string key for the title.
func confirmationDialog<S, A, T>(S, isPresented: Binding<Bool>, titleVisibility: Visibility, presenting: T?, actions: (T) -> A) -> some View
Presents a confirmation dialog using data to produce the dialog’s content and a string variable for the title.

Confirmation Dialogs with a Message

func confirmationDialog<S, A, M>(S, isPresented: Binding<Bool>, titleVisibility: Visibility, actions: () -> A, message: () -> M) -> some View
Presents a confirmation dialog with a message when a given condition is true, using a string variable for the title.
func confirmationDialog<A, M>(LocalizedStringKey, isPresented: Binding<Bool>, titleVisibility: Visibility, actions: () -> A, message: () -> M) -> some View
Presents a confirmation dialog with a message when a given condition is true, using a localized string key for the title.
func confirmationDialog<A, M>(Text, isPresented: Binding<Bool>, titleVisibility: Visibility, actions: () -> A, message: () -> M) -> some View
Presents a confirmation dialog with a message when a given condition is true, using a text view for the title.
func confirmationDialog<A, M, T>(Text, isPresented: Binding<Bool>, titleVisibility: Visibility, presenting: T?, actions: (T) -> A, message: (T) -> M) -> some View
Presents a confirmation dialog with a message using data to produce the dialog’s content and a text view for the message.
func confirmationDialog<S, A, M, T>(S, isPresented: Binding<Bool>, titleVisibility: Visibility, presenting: T?, actions: (T) -> A, message: (T) -> M) -> some View
Presents a confirmation dialog with a message using data to produce the dialog’s content and a string variable for the title.
func confirmationDialog<A, M, T>(LocalizedStringKey, isPresented: Binding<Bool>, titleVisibility: Visibility, presenting: T?, actions: (T) -> A, message: (T) -> M) -> some View
Presents a confirmation dialog with a message using data to produce the dialog’s content and a localized string key for the title.

Sheets

func sheet<Content>(isPresented: Binding<Bool>, onDismiss: (() -> Void)?, content: () -> Content) -> some View
Presents a sheet when a binding to a Boolean value that you provide is true.
func sheet<Item, Content>(item: Binding<Item?>, onDismiss: (() -> Void)?, content: (Item) -> Content) -> some View
Presents a sheet using the given item as a data source for the sheet’s content. シートを提示します、与えられた項目をシートのもつ内容に対するデータソースとして使って。
func fullScreenCover<Content>(isPresented: Binding<Bool>, onDismiss: (() -> Void)?, content: () -> Content) -> some View
Presents a modal view that covers as much of the screen as possible when binding to a Boolean value you provide is true.
func fullScreenCover<Item, Content>(item: Binding<Item?>, onDismiss: (() -> Void)?, content: (Item) -> Content) -> some View
Presents a modal view that covers as much of the screen as possible using the binding you provide as a data source for the sheet’s content.

Popovers

func popover<Content>(isPresented: Binding<Bool>, attachmentAnchor: PopoverAttachmentAnchor, arrowEdge: Edge, content: () -> Content) -> some View
Presents a popover when a given condition is true. ポップオーバーを提示します、与えられた条件がtrueの時に。
func popover<Item, Content>(item: Binding<Item?>, attachmentAnchor: PopoverAttachmentAnchor, arrowEdge: Edge, content: (Item) -> Content) -> some View
Presents a popover using the given item as a data source for the popover’s content. ポップオーバーを提示します、与えられた項目をポップオーバーのもつ内容に対するデータソースとして使って。
enum PopoverAttachmentAnchor
An attachment anchor for a popover.

Sheet and Popover Dismissal

func interactiveDismissDisabled(Bool) -> some View
Conditionally prevents interactive dismissal of a popover or a sheet.

File Managers

func fileExporter<D>(isPresented: Binding<Bool>, document: D?, contentType: UTType, defaultFilename: String?, onCompletion: (Result<URL, Error>) -> Void) -> some View
Presents a system interface for allowing the user to export an in-memory document to a file on disk. あるインメモリ書類をディスク上のファイルにエクスポートすることをユーザに許可するためのシステムインターフェイスを提示します。
func fileExporter<D>(isPresented: Binding<Bool>, document: D?, contentType: UTType, defaultFilename: String?, onCompletion: (Result<URL, Error>) -> Void) -> some View
Presents a system interface for allowing the user to export an in-memory document to a file on disk. あるインメモリ書類をディスク上のファイルにエクスポートすることをユーザに許可するためのシステムインターフェイスを提示します。
func fileExporter<C>(isPresented: Binding<Bool>, documents: C, contentType: UTType, onCompletion: (Result<[URL], Error>) -> Void) -> some View
Presents a system interface for allowing the user to export a collection of in-memory documents to files on disk. インメモリ書類それらからなるあるコレクションをディスク上のファイルにエクスポートすることをユーザに許可するためのシステムインターフェイスを提示します。
func fileExporter<C>(isPresented: Binding<Bool>, documents: C, contentType: UTType, onCompletion: (Result<[URL], Error>) -> Void) -> some View
Presents a system interface for allowing the user to export a collection of in-memory documents to files on disk. インメモリ書類それらからなるあるコレクションをディスク上のファイルにエクスポートすることをユーザに許可するためのシステムインターフェイスを提示します。
func fileImporter(isPresented: Binding<Bool>, allowedContentTypes: [UTType], allowsMultipleSelection: Bool, onCompletion: (Result<[URL], Error>) -> Void) -> some View
Presents a system interface for allowing the user to import multiple files. 複数のファイルをインポートすることをユーザに許可するためのシステムインターフェイスを提示します。
func fileImporter(isPresented: Binding<Bool>, allowedContentTypes: [UTType], onCompletion: (Result<URL, Error>) -> Void) -> some View
Presents a system interface for allowing the user to import an existing file. ある既存のファイルをインポートすることをユーザに許可するためのシステムインターフェイスを提示します。
func fileMover(isPresented: Binding<Bool>, file: URL?, onCompletion: (Result<URL, Error>) -> Void) -> some View
Presents a system interface for allowing the user to move an existing file to a new location. ある既存のファイルを新しい場所に移動することをユーザに許可するためのシステムインターフェイスを提示します。
func fileMover<C>(isPresented: Binding<Bool>, files: C, onCompletion: (Result<[URL], Error>) -> Void) -> some View
Presents a system interface for allowing the user to move a collection of existing files to a new location. 既存のファイルそれらからなるあるコレクションを新しい場所に移動することをユーザに許可するためのシステムインターフェイスを提示します。

Quick Look Previews

func quickLookPreview(Binding<URL?>) -> some View
Presents a Quick Look preview of a single URL.
func quickLookPreview<Items>(Binding<Items.Element?>, in: Items) -> some View
Presents a Quick Look preview of the given URLs.

Family Controls

func familyActivityPicker(isPresented: Binding<Bool>, selection: Binding<FamilyActivitySelection>) -> some View
Presents an activity picker view as a sheet.

Apple Music

func musicSubscriptionOffer(isPresented: Binding<Bool>, options: MusicSubscriptionOffer.Options, onLoadCompletion: (Error?) -> Void) -> some View
Initiates the process of presenting a sheet with subscription offers for Apple Music when the isPresented binding is true.

See Also 参照

Providing Interactivity 相互作用性を提供する

Input and Event Modifiers
Supply actions for a view to perform in response to user input and system events. アクションをビューに提供して、ユーザ入力とシステムイベントに応答して実行します。
State Modifiers
Access storage and provide child views with configuration data.