View ModifieriOS 16.4+macOS 13.3+tvOS 16.4+watchOS 9.4+
Overloads
2 ways to call compose().presentationBackground(). Each is one SwiftUI overload, picked by the arguments you pass.
compose().presentationBackground(style: SwiftUI.ShapeStyle)nonisolated func presentationBackground<S>(
_ style: S
) -> some View
where S : ShapeStyleParameters
style*SwiftUI.ShapeStyleThe shape style to use as the presentation background.
Discussion
The following example uses the Material.thick material as the sheet
background:
struct ContentView: View {
@State private var showSettings = false
var body: some View {
Button("View Settings") {
showSettings = true
}
.sheet(isPresented: $showSettings) {
SettingsView()
.presentationBackground(.thickMaterial)
}
}
}The presentationBackground(_:) modifier differs from the
View.background(_:ignoresSafeAreaEdges:) modifier in several key
ways. A presentation background:
- Automatically fills the entire presentation.
- Allows views behind the presentation to show through translucent styles on supported platforms.
or transparency — the background is always opaque.
See also
More in Presentation.
- alertPresents an alert when a given condition is true, using a localized string resource for the title.
- confirmationDialogPresents a confirmation dialog when a given condition is true, using a localized string resource for the title.
- contextMenuAdds an item-based context menu to a view.
- dialogIconConfigures the icon used by dialogs within this view.
- dialogSuppressionToggleEnables user suppression of dialogs and alerts presented within self, with a custom suppression message on macOS. Unused on other platforms.
- dismissalConfirmationDialogPresents a confirmation dialog upon an attempt to dismiss the window for this view.
- documentBrowserContextMenuAdds to a DocumentLaunchView actions that accept a list of selected files as their parameter.
- fileDialogBrowserOptionsOn macOS, configures the fileExporter, fileImporter, or fileMover to provide a refined URL search experience: include or exclude hidden files, allow searching by tag, etc.
- fileDialogConfirmationLabelOn macOS, configures the fileExporter, fileImporter, or fileMover with a custom confirmation button label.
- fileDialogCustomizationIDOn macOS, configures the fileExporter, fileImporter, or fileMover to persist and restore the file dialog configuration.
- fileDialogDefaultDirectoryConfigures the fileExporter, fileImporter, or fileMover to open with the specified default directory.
- fileDialogImportsUnresolvedAliasesOn macOS, configures the fileExporter, fileImporter, or fileMover behavior when a user chooses an alias.