Swift version: 5.6
UISearchController
is a small component designed to make it easy and consistent to add searching to any view controller. Adding it only takes a few small steps:
UISearchResultsUpdating
.updateSearchResults()
.Let’s go through them here. First, open Main.storyboard, select your view controller, then embed it in a navigation controller – go to the Editor menu and choose Embed In > Navigation Controller.
Second, modify your view controller’s definition so that it includes a conformance for UISearchResultsUpdating
.
Third, add some code to viewDidLoad()
to create the search controller and assign it to the current view controller. The search controller actually belongs as a property of the navigation item of the view controller, which automatically places it inside your navigation bar when the view controller is displayed.
let search = UISearchController(searchResultsController: nil)
search.searchResultsUpdater = self
search.obscuresBackgroundDuringPresentation = false
search.searchBar.placeholder = "Type something here to search"
navigationItem.searchController = search
Finally, implement the updateSearchResults()
method to update your search results. This method gets called every time the user types anything into the search bar, so it’s your job to use their new text to filter your data however you want:
func updateSearchResults(for searchController: UISearchController) {
guard let text = searchController.searchBar.text else { return }
print(text)
}
That’s it!
TAKE YOUR SKILLS TO THE NEXT LEVEL If you like Hacking with Swift, you'll love Hacking with Swift+ – it's my premium service where you can learn advanced Swift and SwiftUI, functional programming, algorithms, and more. Plus it comes with stacks of benefits, including monthly live streams, downloadable projects, a 20% discount on all books, and free gifts!
Sponsor Hacking with Swift and reach the world's largest Swift community!
Available from iOS 8.0
This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.
Link copied to your pasteboard.