UISearchController 讓使用者能透過 UISearchBar 輸入關鍵字,並即時顯示搜尋結果。它通常會搭配一個結果控制器,讓搜尋流程更清楚。
建立 UISearchController 時,可傳入負責顯示結果的子控制器。接著設定 searchResultsUpdater,並把 searchBar 放到父控制器的表頭或導覽列區域。
searchResultsUpdater 需要實作 updateSearchResults 方法。當搜尋框成為第一響應者,或文字改變時,這個方法會被呼叫。你可以在其中更新結果資料並刷新 UI。
預設情況下,點擊搜尋框會隱藏導覽列並出現蒙版。若想保留導覽列,可將 hidesNavigationBarDuringPresentation 設為 false。若想允許使用者點擊背景,可將 dimsBackgroundDuringPresentation 設為 false。
若希望搜尋框為空時也顯示子控制器,可在 updateSearchResults 中將結果控制器的 view.isHidden 設為 false。否則預設會在沒有輸入文字時隱藏結果畫面。
若 searchBar 已放在父控制器上,可用 becomeFirstResponder 讓鍵盤彈出。若希望只顯示搜尋介面但不彈出鍵盤,可透過 present 或設定 isActive。
整體而言,UISearchController 適合需要即時過濾清單的場景,例如聯絡人搜尋、商品搜尋或歷史紀錄查詢。