• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

UISearchController,SearchBar的教程-Swift

原作者: [db:作者] 来自: [db:来源] 收藏 邀请

如果你的应用程序里显示了大量的数据,滚动的查看大规模的列表会很慢,也会给人一种烦躁的感觉。在这种情况下,查询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数组。否则,数据来自项目的完整列表。

我们来回想一下,搜索结果显示和隐藏的控制器自动处理,所以,所有代码要做的就是提供正确的数据,根据控制器的状态来判断是否用户已经搜索到一些东西了。

运行你的项目,你已经得到了一个有功能的搜索栏啦。


鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
Swift中文教程(五)--对象和类发布时间:2022-07-13
下一篇:
[Swift]LeetCode191.位1的个数|Numberof1Bits发布时间:2022-07-13
热门推荐
热门话题
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap