iOS UISearchController的使用方法

2020-07-26 02:55:40

字體：大中小

供稿：網(wǎng)友

UISearchController 讓用戶在 UISearchBar 上輸入搜索關(guān)鍵詞，展示搜索結(jié)果或者進(jìn)行其他操作。UISearchController 把兩個(gè)控制器(UIViewController)連在一起。父控制器放置 UISearchBar 控件。當(dāng)用戶點(diǎn)擊搜索框時(shí)，UISearchBar 會(huì)移到屏幕頂部；輸入搜索關(guān)鍵詞，UISearchBar 下面出現(xiàn)子控制器的view。當(dāng)然，也可以用代碼使 UISearchBar 和子控制器展示出來(lái)，即便父控制器沒(méi)有放置 UISearchBar。

一般用法

在父控制器中創(chuàng)建子控制器
用子控制器創(chuàng)建 UISearchController，通常會(huì)把 UISearchController 變成父控制器的屬性
設(shè)置 UISearchController 的searchResultsUpdater屬性
通常會(huì)在父控制器上放置 UISearchController 的searchBar
把父控制器definesPresentationContext屬性設(shè)置為 true

以下為父控制器代碼示例

let searchResultsVC = SearchResultsVC(allStrings: allStrings)searchController = UISearchController(searchResultsController: searchResultsVC)searchController.searchResultsUpdater = searchResultsVC;let tableView = UITableView(frame: view.bounds)tableView.dataSource = selfview.addSubview(tableView)tableView.tableHeaderView = searchController.searchBar;tableView.tableFooterView = UIView()definesPresentationContext = true;

UISearchController 的searchResultsUpdater屬性一般設(shè)置為父控制器或子控制器。這個(gè)屬性的值要符合 UISearchResultsUpdating 協(xié)議，實(shí)現(xiàn)updateSearchResults(for searchController: UISearchController)方法。這個(gè)方法會(huì)在searchBar變?yōu)榈谝豁憫?yīng)者(比如，當(dāng)用戶點(diǎn)擊搜索框，鍵盤彈出)，以及搜索關(guān)鍵詞改變時(shí)調(diào)用。在這個(gè)方法中寫入執(zhí)行搜索、更新 UI 的代碼。

以上代碼將子控制器作為 UISearchController 的searchResultsUpdater。假設(shè)子控制器的數(shù)據(jù)源為 allStrings 和 strings，均為含 String 的 Array。其中，allStrings 為常量，包含所有的 String；strings 包含符合搜索條件的 String，需要在用戶輸入時(shí)更新。搜索條件為，含有用戶輸入的內(nèi)容，不區(qū)分大小寫。用 UITableView 展示搜索結(jié)果。在updateSearchResults(for searchController: UISearchController)方法中，獲取 searchBar 的text，更新 strings，更新 UI。

以下是子控制器代碼示例

func updateSearchResults(for searchController: UISearchController) { strings.removeAll() if let text = searchController.searchBar.text?.uppercased(), !text.isEmpty {  strings = allStrings.filter { $0.contains(text) } } tableView.reloadData()}

改變樣式

默認(rèn)情況下，用戶點(diǎn)擊搜索框，導(dǎo)航欄(navigation bar)隱藏，UISearchBar 上移，下面能看到父控制器，但有灰色蒙版遮擋。點(diǎn)擊灰色蒙版，退回父控制器。把 UISearchController 的hidesNavigationBarDuringPresentation屬性設(shè)置為false，則導(dǎo)航欄不隱藏。把 UISearchController 的dimsBackgroundDuringPresentation屬性設(shè)置為false，則灰色蒙版不顯示，能點(diǎn)擊父控制器。

搜索框?yàn)榭諘r(shí)，子控制器隱藏

如果 UISearchController 的searchBar已經(jīng)放置在父控制器上，用戶點(diǎn)擊搜索框時(shí)，UISearchBar 會(huì)上移至屏幕頂部，鍵盤彈出。此時(shí)會(huì)調(diào)用updateSearchResults(for searchController: UISearchController)方法，但子控制的view沒(méi)有出現(xiàn)，isHidden為 true。輸入內(nèi)容后，子控制器的view才出現(xiàn)。清空輸入的內(nèi)容，子控制器的view消失。如果要在搜索框?yàn)榭諘r(shí)也顯示子控制器，在updateSearchResults(for searchController: UISearchController)方法中加入searchController.searchResultsController?.view.isHidden = false即可。

代碼展示 UISearchBar 和子控制器的方法

在父控制中可以用代碼來(lái)展示 UISearchBar 和子控制器，具體實(shí)現(xiàn)方法要看 UISearchController 的searchBar是否放置在父控制器上。

如果 UISearchController 的searchBar放置在父控制器上

UISearchBar 上移，彈出鍵盤(和用戶點(diǎn)擊搜索框一樣的效果)

searchController.searchBar.becomeFirstResponder()

UISearchBar 上移，但不彈出鍵盤

present(searchController, animated: true, completion: nil)

或者

searchController.isActive = true

如果 UISearchController 的searchBar不在父控制器上

UISearchBar 從頂部出現(xiàn)，彈出鍵盤

present(searchController, animated: true, completion: nil)