toolbarMinimizationBehavior

Sets the minimize behavior for the specified bars.

View ModifieriOS 27.0+macOS 27.0+tvOS 27.0+watchOS 27.0+visionOS 27.0+toolbarMinimizationBehavior(_:for:) in SwiftUI

Declaration

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

Parameters

Discussion

Use this modifier to enable toolbar minimization in response to scrolling. The supported placement is ToolbarPlacement.navigationBar. When the navigation bar minimizes, an integrated top tab bar will also minimize.

By default, the safe area adjusts as the navigation bar minimizes. Use toolbarMinimizationSafeAreaAdjustment(_:for:) to customize this.

NavigationStack {
    ScrollView {
        ForEach(0 ..< 50) { index in
            Text("\(index)").padding()
        }
    }
    .navigationTitle("Minimizing Title")
    .toolbarMinimizationBehavior(.onScrollDown, for: .navigationBar)
}

See also

More in Navigation.