toolbarVerticalCompressionBehavior

Sets how bars should compress when different types of toolbars are hosted together and space is constrained.

View ModifieriOS 27.1+macOS 27.1+tvOS 27.1+watchOS 27.1+visionOS 27.1+toolbarVerticalCompressionBehavior(_:) in SwiftUI

Declaration

React
compose().toolbarVerticalCompressionBehavior(
  behavior: SwiftUI.ToolbarVerticalCompressionBehavior
)
Swift
nonisolated func toolbarVerticalCompressionBehavior(
    _ behavior: ToolbarVerticalCompressionBehavior
) -> some View

Parameters

Discussion

For example, a productivity-focused app like Files could ensure its toolbar items are preferred over the tab bar:

struct ContentView: View {
    var body: some View {
        TabView {
            Tab("Recents") {
                NavigationStack {
                    RootView()
                        .toolbar {
                            Button("Up", systemImage: "chevron.up") {
                            }
                            Button("Down", systemImage: "chevron.down") {
                            }
                        }
                        .toolbarVerticalCompressionBehavior(.prefersToolbarItems)
                }
            }
        }
    }
}

See also

More in Navigation.