toolbarMinimizationSafeAreaAdjustment

Sets the safe area adjustment for the specified bars during minimization.

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

Declaration

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

Parameters

Discussion

By default, the safe area adjusts as bars minimize, allowing content to reflow into the space vacated by the bar. Use this modifier to disable that adjustment when content should remain in place -- for example, when displaying full-bleed media beneath a minimizing bar.

Currently, only ToolbarPlacement.navigationBar supports customizing the safe area adjustment.

Use this modifier alongside toolbarMinimizationBehavior(_:for:):

NavigationStack {
    ScrollView {
        // ...
    }
    .toolbarMinimizationBehavior(
        .onScrollDown, for: .navigationBar)
    .toolbarMinimizationSafeAreaAdjustment(
        .disabled, for: .navigationBar)
}

See also

More in Navigation.