toolbarVisibility

Specifies the visibility of a bar managed by SwiftUI.

View ModifieriOS 18.0+macOS 15.0+tvOS 18.0+watchOS 11.0+visionOS 2.0+toolbarVisibility(_:for:) in SwiftUI

Declaration

React
compose().toolbarVisibility(
  visibility: SwiftUI.Visibility,
  options: {
    for: SwiftUI.ToolbarPlacement[];
  }
)
Swift
nonisolated func toolbarVisibility(
    _ visibility: Visibility,
    for bars: ToolbarPlacement...
) -> some View

Parameters

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.