如果你的应用程序里显示了大量的数据，滚动的查看大规模的列表会很慢，也会给人一种烦躁的感觉。在这种情况下，查询UISearchController, UISearchBar是极其重要的，可以让用户搜索特点的项目。非常幸运的是，UIKit包含了UISearchBar, 并且完美的集成了UITableView. 在这个UISearchController的教程中，你将要构建一个可搜索的糖果App, e而这个APP是基于标准的视图表。你将添加一个searchBar, 包括动态过滤，并添加一个可选的搜索范围，同时利用UISearchController。 最后你就会知道，如何让你的应用程序更加的满足用户需求。
准备好了搜索一些糖果的结果了么？？
准备开始咯！
首先下载“最开始的项目here”，然后打开这个程序。 这个App已经被我设置了一个导航控制器和特定的风格。运行你的程序，你会看到一个空的列表：
返回到Xcode中，文件Candy.Swift包含了一个类来存储所有的信息关于你将要显示的糖果。这个类有两个属性，类别和糖果名字。
当用户在你的app中查找糖果的时候，你要把糖果的名字属性对应到用户搜索的字符串中。
填充表视图
打开MasterViewController.swift. candies属性将是你管理所有不同糖果的地方，说到这里，是时候创建一些糖果啦！
在这个教程里，你需要创建一些值来说明搜索栏是如何工作的。在app中，你可能有成千上万的这些可搜索的对象。但是应用程序是否有成千上万的对象搜索呢？其实方法都是相同的，可伸缩的是最好的。
为了填充你的candies数组，添加下面的代码到viewDidLoad(), 之后调用super.viewDidLoad():
candies = [ Candy(category:"Chocolate", name:"Chocolate Bar"), Candy(category:"Chocolate", name:"Chocolate Chip"), Candy(category:"Chocolate", name:"Dark Chocolate"), Candy(category:"Hard", name:"Lollipop"), Candy(category:"Hard", name:"Candy Cane"), Candy(category:"Hard", name:"Jaw Breaker"), Candy(category:"Other", name:"Caramel"), Candy(category:"Other", name:"Sour Chew"), Candy(category:"Other", name:"Gummi Bear") ] |
运行你的项目，由于表格视图的代理和数据源方法已经实现了，你会发现你已经有了一个工作视图表啦：
选择表格里的任一一行，会对应的显示出来一个细节视图：
这么多的糖果，如此短的时间就找到你想要的那一款，那么 你需要一个UISearchBar.
UISearchController的简介
如果你看一下UISearchBar的文档，你会发现开发者很懒。它不做任何的搜索工作。类只是简单的提供了一个标准的接口，也就是用户从iOSapp里所期望的那样。
UISearchController和代理协议一起让其他应用程序知道用户做了什么。你必须写出所有的字符串来匹配给自己。
尽管这样讲起来可能有点吓人，但是编写自定义的搜索功能会严格控制在你的app中。如果你使用过ios搜索视图表，你应该会熟悉UISearchDisplayController. 自从IOS 8以来，这类UISearchController已经废弃 不再使用了，这样简化了整个搜索过程，但是，在编写文本时，界面构建器不支持UISearchController, 所以你必须通过编程的方式来创建UI.
在MasterViewController.swift, 添加一个新的属性：
let searchController = UISearchController(searchResultsController: nil) |
通过初始化UISearchController, 你告诉你想要的搜索控制器，你搜索的结果显示使用相同的视图。如果你指定一个不同的视图管理器，那么它将会用来显示结果。
接下来，你将要设置一些searchController的参数。还是在MasterViewController.swift里， 添加下面的代码到viewDidLoad():
searchController.searchResultsUpdater = self searchController.dimsBackgroundDuringPresentation = false definesPresentationContext = true tableView.tableHeaderView = searchController.searchBar |
让我们来解析一下写的这四行代码：
1. searchResultsUpdater是一个在UISearchController的属性，遵守UISearchResultsUpdating的协议。这个协议允许你的类被通知当UISearchBar的文本变化的时候。你需要在短时间内遵守这个协议。
2. 默认情况下，UISearchController将暗色调的呈现你的视图。这是非常有用的，但是如果你用的是另一个视图控制器来做searchResultsController，在这种情况下，你将设置当前的视图来显示结果，所以你不需要暗色调的视图。
3.通过设置definesPresentationContext为true, 你确保了searchBar不会一直在屏幕上当用户导航到另外一个视图控制器上。
4. 最后，你添加了searchBar到你的表格视图中的tableHeaderView. 记住这个接口尚未与UISearchController兼容，所以这是你必须要做的。
UISearch结果的更新和过滤。
当你设置好了搜索控制器之后，你需要写一些代码来让它工作。 首先呢，添加一下的属性到MasterViewController的顶部：
var filteredCandies = [Candy]() |
这个属性就是用户要用来搜索糖果的，接下来，添加以下的方法到MasterViewController类里：
func filterContentForSearchText(searchText: String, scope: String = "All") {
filteredCandies = candies.filter { candy in
return candy.name.lowercaseString.containsString(searchText.lowercaseString)
}
tableView.reloadData()
}
|
这个过滤糖果的数组的建立是基于searchText, 然后将结果放到filteredCandies的数组里。你现在不用担心范围参数，你将会用到它在本章的最后一部分。
为了允许MasterViewController来回应searchBar,它将不得不实现UISearchResultsUpdateing. 打开MasterViewController.swift , 添加下面的扩展类，在MasterViewController这个类之外：
extension MasterViewController: UISearchResultsUpdating {
func updateSearchResultsForSearchController(searchController: UISearchController) {
filterContentForSearchText(searchController.searchBar.text!)
}
}
这个updateSearchResultForSeachController(_:)的方法是唯一方法来遵守UISearchResultsUpdating的协议。
现在，当用户在搜索栏，添加或删除文本时，UISearchController会通知MasterViewController这个类。这个方法本身是一个help方法的调用。filter（）需要一个闭包（candy: candy）->Bool. 然后循环遍历所有元素的数组，通过当前的每一个元素。
你可以使用它来确定是否一个糖果应该在搜索结果里展示给用户。为了确定这一点，你需要返回true, 如果当前的糖果包含在数组里。如果不是，那么返回false.
containString(_:)是用来检查所有糖果的名字包含searchText. 你可以用lowercaseString方法将两个字符串转换为小写的。
运行你的项目吧。你会发现现在已经有了一个SearchBar搜索栏在图表的顶部。
但是，如果你输入一些文字，你还是看不到任何的结果和变化。 这个是因为你还没有编写代码的原因。图表视图还不知道你用了过滤结果。
回到MasterViewController.swift，代替tableView(_:numberOfRowsInSection:):
override func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
if searchController.active && searchController.searchBar.text != "" {
return filteredCandies.count
}
return candies.count
}
|
其实也没有太大的改动啦，你可以查看是否用户在查询，和使用过滤后的正常糖果作为表的数据源。
接下来，替代tableView(_:cellForRowAtIndexPath:):
override func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
let cell = tableView.dequeueReusableCellWithIdentifier("Cell", forIndexPath: indexPath)
let candy: Candy
if searchController.active && searchController.searchBar.text != "" {
candy = filteredCandies[indexPath.row]
} else {
candy = candies[indexPath.row]
}
cell.textLabel?.text = candy.name
cell.detailTextLabel?.text = candy.category
return cell
}
|
这两个方法的active属性是指的searchController确定要显示的数组。当用户点击搜索框的搜索栏，active将自动的设置为true.
如果搜索控制器是active的，你可以看到用户是否输入在搜索框的内容。如果有，返回的数据是来源自filteredCandies数组。否则，数据来自项目的完整列表。
我们来回想一下，搜索结果显示和隐藏的控制器自动处理，所以，所有代码要做的就是提供正确的数据，根据控制器的状态来判断是否用户已经搜索到一些东西了。
运行你的项目，你已经得到了一个有功能的搜索栏啦。
