Declaration
compose().toolbarBackground(
style: SwiftUI.ShapeStyle,
options: {
for: SwiftUI.ToolbarPlacement[];
}
)nonisolated func toolbarBackground<S>(
_ style: S,
for bars: ToolbarPlacement...
) -> some View
where S : ShapeStyleParameters
style*SwiftUI.ShapeStyleThe style to display as the background of the bar.
options.for*SwiftUI.ToolbarPlacement[]
Discussion
The preferred style flows up to the nearest container that
renders a bar. This could be a NavigationView or TabView
in iOS, or the root view of a WindowGroup in macOS. This example
shows a view that renders the navigation bar with a blue background
and dark color scheme.
NavigationView {
ContentView()
.toolbarBackground(.white)
.toolbarColorScheme(.dark)
}You can provide multiple ToolbarPlacement instances to customize
multiple bars at once.
TabView {
NavigationView {
ContentView()
.toolbarBackground(
.blue, for: .navigationBar, .tabBar)
.toolbarColorScheme(
.dark, for: .navigationBar, .tabBar)
}
}When used within a TabView, the specified style will be
preferred while the tab is currently active. You can use a Group
to specify the same preferred background for every tab.
TabView {
Group {
MainView()
SettingsView()
}
.toolbarBackground(.blue, for: .tabBar)
}Depending on the specified bars, the requested style may not be able to be fullfilled.
See also
More in Navigation.
- assistiveAccessNavigationIconConfigures the view's icon for purposes of navigation.
- asyncImageURLSessionA modifier that adds a URL session for asynchronous images contained in the view to use when fetching image data.
- contentToolbarPopulates the toolbar of the specified content view type with the views you provide.
- defaultAdaptableTabBarPlacementSpecifies the default placement for the tabs in a tab view using the adaptable sidebar style.
- defaultTabBarPlacementSpecifies the preferred placement for the tabs of a TabView in the TabViewStyle.sidebarAdaptable style on platforms where the tab bar cannot adapt between different representations, and only one representation can be shown.
- navigationBarBackButtonHiddenHides the navigation bar back button for the view.
- navigationBarTitleDisplayModeConfigures the title display mode for this view.
- navigationDestinationAssociates a destination view with a presented data type for use within a navigation stack.
- navigationDocumentConfigures the view's document for purposes of navigation.
- navigationLinkIndicatorVisibilityConfigures whether navigation links show a disclosure indicator.
- navigationSplitViewColumnWidthSets a fixed, preferred width for the column containing this view.
- navigationSubtitleConfigures the view's subtitle for purposes of navigation, using a localized string resource.