How it works
SearchPresentationToolbarBehavior is a set of constants that tells SwiftUI how entering a search presentation should affect the surrounding toolbar. By default, when a search field becomes active, SwiftUI may hide toolbar content to give the search interface room — which can be jarring if that content is still relevant while the person is searching. Reach for SearchPresentationToolbarBehavior when you want explicit control over whether the toolbar collapses during search, applying it through the searchPresentationToolbarBehavior(_:) modifier on a searchable view hierarchy.
Make the view searchable with searchable(text:)
The behavior only has meaning where a search field exists, so it attaches to a hierarchy that has already opted into search. Here the
Listis bound to a query through.searchable(text: $query), withquerydeclared as@State private var query = "", establishing the search presentation whose toolbar treatment you then customize.Apply searchPresentationToolbarBehavior(_:)
This modifier takes a
SearchPresentationToolbarBehaviorvalue and propagates it to the search presentation in the enclosing context. In the example it is chained directly after the searchable declaration as.searchPresentationToolbarBehavior(.avoidHidingContent), scoping the chosen behavior to thisNavigationStackand its toolbar.Choose the .avoidHidingContent constant
SearchPresentationToolbarBehaviorexposes its options as type properties, and.avoidHidingContentinstructs SwiftUI to keep existing toolbar content visible rather than hiding it when search becomes active. This is the value passed in the example, so toolbar items remain on screen while the person types into the search field instead of being collapsed away.Let the navigation container supply the toolbar context
The behavior governs a toolbar, so it needs a host that provides one. The
NavigationStackplus.navigationTitle("Fruits")give the search presentation a navigation bar to act on, which is the surfaceSearchPresentationToolbarBehaviordecides whether to preserve or hide.
.searchPresentationToolbarBehavior(.avoidHidingContent) for .searchPresentationToolbarBehavior(.automatic) and activate the search field to watch the toolbar revert to SwiftUI's default hiding behavior.Example & preview
Press Run live & edit to compile it in your browser — then edit the Swift on the left and the preview re-renders live.
struct SearchPresentationToolbarBehaviorDemo: View {
@State private var query = ""
let fruits = ["Apple", "Banana", "Cherry", "Mango"]
var body: some View {
NavigationStack {
List(fruits.filter { query.isEmpty || $0.localizedCaseInsensitiveContains(query) }, id: \.self) { fruit in
Text(fruit)
}
.navigationTitle("Fruits")
.searchable(text: $query)
.searchPresentationToolbarBehavior(.avoidHidingContent)
}
}
}