View ModifieriOS 18.0+macOS 15.0+tvOS 18.0+watchOS 11.0+visionOS 2.0+toolbarVisibility(_:for:) in SwiftUI
Declaration
compose().toolbarVisibility(
visibility: SwiftUI.Visibility,
options: {
for: SwiftUI.ToolbarPlacement[];
}
)nonisolated func toolbarVisibility(
_ visibility: Visibility,
for bars: ToolbarPlacement...
) -> some ViewParameters
visibility*SwiftUI.VisibilityThe preferred visibility of the bar.
options.for*SwiftUI.ToolbarPlacement[]
Discussion
The preferred visibility 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 examples shows a view that hides the navigation bar on iOS, or the window toolbar items on macOS.
NavigationView {
ContentView()
.toolbarVisibility(.hidden)
}To hide the entire titlebar on macOS, use this modifier with
ToolbarPlacement.windowToolbar placement.
NavigationView {
ContentView()
.toolbarVisibility(.hidden, for: .windowToolbar)
}You can provide multiple ToolbarPlacement instances to hide
multiple bars at once.
TabView {
NavigationView {
ContentView()
.toolbarVisibility(
.hidden, for: .navigationBar, .tabBar)
}
}Depending on the specified bars, the requested visibility may not be able to be fulfilled.
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.