toolbarMinimizationRestoration
Sets the restoration behavior for the specified bars during minimization.
View ModifieriOS 27.0+macOS 27.0+tvOS 27.0+watchOS 27.0+visionOS 27.0+toolbarMinimizationRestoration(_:for:) in SwiftUI
Declaration
compose().toolbarMinimizationRestoration(
restoration: SwiftUI.ToolbarMinimizationRestoration,
options: {
for: SwiftUI.ToolbarPlacement[];
}
)nonisolated func toolbarMinimizationRestoration(
_ restoration: ToolbarMinimizationRestoration,
for bars: ToolbarPlacement...
) -> some ViewParameters
restoration*SwiftUI.ToolbarMinimizationRestorationThe restoration behavior.
options.for*SwiftUI.ToolbarPlacement[]
Discussion
Use this modifier alongside toolbarMinimizationBehavior(_:for:)
to customize when a minimized bar restores. By default, the bar
restores when the user reverses scroll direction. Use
ToolbarMinimizationRestoration.atScrollEdge to restrict
restoration to when the scroll view's content reaches the scroll
edge -- appropriate for screens where the bar is mostly chrome
that doesn't need to follow the user.
NavigationStack {
ScrollView {
// ...
}
.toolbarMinimizationBehavior(
.onScrollDown, for: .navigationBar)
.toolbarMinimizationRestoration(
.atScrollEdge, for: .navigationBar)
}Currently, only ToolbarPlacement.navigationBar supports
customizing the restoration behavior, and only when used in
combination with ToolbarMinimizationBehavior.onScrollDown.
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.