對UISearchController的探索(一)

前言

在楊武老師講的TableView視頻里面,有這么一段介紹了搜索的部分。
UISearchBar(iOS2+)
UISearchDisplayController(iOS7)
UISearchController(iOS8)
UISearchController是作為現在最新的搜索工具,具體怎么用也沒有講解,正好我也沒有學過,所以想從文檔入手,查看怎么去使用一個UISearchController。
全文語言為Swift。
全部資料來自Document and Api Reference。


初始化

![init][1]

這里的參數searchResultsController為展示搜索結果的UIViewController類的對象,如果展示搜索結果的界面與自己搜索結果的頁面是同一個視圖,那么就直接填寫nil。

現在就來初始化一個UISearchController。并將其放入自己的TableView中,因為本篇主要講解UISearchController,所以創建TableView的過程略過。

  var searchController:UISearchController = UISearchController.init(searchResultsController: nil)

 //MARK:- Life cycle
    override func viewDidLoad()
    {
        super.viewDidLoad()
        self.tableview.tableHeaderView = self.searchController.searchBar;
    }


Active

![Active][2]
active屬性表示搜索界面的狀態,只讀屬性。


Delegate

![delegate][3]
delegate就是UISearchController的代理。
如果要設置代理,首先要繼承UISearchControllerDelegate這個協議。
在點進去協議后可以看到里面的方法。

public protocol UISearchControllerDelegate : NSObjectProtocol {
    
   // These methods are called when automatic presentation or dismissal occurs. 
   //They will not be called if you present or dismiss the search controller yourself.
    @available(iOS 8.0, *)
    optional public func willPresentSearchController(searchController: UISearchController)
    @available(iOS 8.0, *)
    optional public func didPresentSearchController(searchController: UISearchController)
    @available(iOS 8.0, *)
    optional public func willDismissSearchController(searchController: UISearchController)
    @available(iOS 8.0, *)
    optional public func didDismissSearchController(searchController: UISearchController)
    
    // Called after the search controller's search bar has agreed to begin editing or when 'active' is set to YES. 
   //If you choose not to present the controller yourself or do not implement this method, a default presentation is performed on your behalf.
    @available(iOS 8.0, *)
    optional public func presentSearchController(searchController: UISearchController)
}

可以看出都是可選方法,應該是UISearchController的Life cycle。我們可以結合剛剛的active屬性,去模擬這些方法發生的時間順序。

//MARK:- UISearchControllerDelegate
    func presentSearchController(searchController: UISearchController) {
        print("presentSearchController \(searchController.active)");
    }
    func willPresentSearchController(searchController: UISearchController) {
        print("willPresentSearchController \(searchController.active)");
    }
    func didPresentSearchController(searchController: UISearchController) {
         print("didPresentSearchController \(searchController.active)");
    }
    func didDismissSearchController(searchController: UISearchController) {
        print("didPresentSearchController \(searchController.active)");
    }
    func willDismissSearchController(searchController: UISearchController) {
        print("willDismissSearchController \(searchController.active)");
    }

運行程序。
點擊搜索欄。
![s1][4]

presentSearchController false
willPresentSearchController false
didPresentSearchController true

![s2][5]
點擊cancel

willDismissSearchController true
didPresentSearchController false


dimsBackgroundDuringPresentation

![4.png-120kB][6]
決定在搜索時,底層的內容是否要變暗。
默認值是true。

默認情況就是這樣:
![dimTure][7]

如果我們設定為false
設定代碼

self.searchController.dimsBackgroundDuringPresentation = false

那么現在搜索時界面就是這樣:
![dimFalse][8]


hidesNavigationBarDuringPresentation

![hideNav][9]
在搜索欄使用的時候是否需要隱藏NavigationBar,默認值為true。
效果圖:
![hideTure][10]
如果我們設定為false
設定代碼

self.searchController.hidesNavigationBarDuringPresentation = false

那么現在界面就是這樣:
![hideFalse][11]


searchBar

![searchBar][12]

search controller 所使用的 search bar 對象,只讀屬性。


searchResultsController

![searchController][13]

管理搜索結果的 view controller,只讀屬性。


searchResultsUpdater

![searchResultsUpdater][14]

該對象更新搜索結果的view controller的內容。

因為id< UISearchResultsUpdating >可以看出這也是一個delegate
所以這時候我們給class繼承UISearchResultsUpdating協議。

class ViewController: UIViewController,UITableViewDelegate,UITableViewDataSource ,UISearchControllerDelegate ,UISearchResultsUpdating 

并設置代理。

  self.searchController.searchResultsUpdater=self

點進UISearchResultsUpdating協議中,查看其代理方法。
![update][15]
發現只有一個方法,- updateSearchResultsForSearchController:,該方法在點擊search bar或者用戶改變search bar的時候會被調用。
另外該方法是Required,說明必須要實現。

   //MARK:- UISearchResultsUpdating
    func updateSearchResultsForSearchController(searchController: UISearchController)
    {
        
    }

結尾

updateSearchResultsForSearchController這個方法是UISearchController的關鍵部分,更新將稍后放出。
[1]: http://static.zybuluo.com/zandhappy/49xgvujsu7f8hl03iy02eba5/1.png
[2]: http://static.zybuluo.com/zandhappy/26wknsmzx4w8rwlimonuq0uo/2.png
[3]: http://static.zybuluo.com/zandhappy/uusxt8eodiblqfj8o6wvu8zp/3.png
[4]: http://static.zybuluo.com/zandhappy/qinsgrldr0qa1a1m3eldgg9z/s1.png
[5]: http://static.zybuluo.com/zandhappy/424585967r3kk0afik0o5pfq/s2.png
[6]: http://static.zybuluo.com/zandhappy/nm6bu5uc6xx85qluh2w0eq3q/4.png
[7]: http://static.zybuluo.com/zandhappy/x1icvr4xoelekvg80mm8u7ov/dimTure.png
[8]: http://static.zybuluo.com/zandhappy/olt64voim51c6oirfidzjqgy/dimno.png
[9]: http://static.zybuluo.com/zandhappy/076mjoufk3ecky99jdblzlms/hideNav.png
[10]: http://static.zybuluo.com/zandhappy/ohzqydions6b5nbi1dvtmzr8/hideTure.png
[11]: http://static.zybuluo.com/zandhappy/ef7klmo7uf4eby83ka2bu2sb/hideFalse.png
[12]: http://static.zybuluo.com/zandhappy/hjuea4g5b51i81q3tf0bsy3h/searchBar.png
[13]: http://static.zybuluo.com/zandhappy/w22iiq9e0t97q5at5l65rfq8/searchController.png
[14]: http://static.zybuluo.com/zandhappy/ci63l8wyva1wq4irbk0wxhav/searchResultsUpdater%20.png
[15]: http://static.zybuluo.com/zandhappy/f4vgv609mb81aaq1ac1rucc6/update.png

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,321評論 6 543
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,559評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,442評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,835評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,581評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,922評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,931評論 3 447
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,096評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,639評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,374評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,591評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,104評論 5 364
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,789評論 3 349
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,196評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,524評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,322評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,554評論 2 379

推薦閱讀更多精彩內容