UISearchController

一、简介

UISearchController是iOS 8 之后推出的一个新的控件, 用于创建搜索条, 及管理搜索事件，一般不单独使用。都是与tableView 结合使用。

二、属性及方法

1. 初始化方法

   initWithSearchResultsController (nullable UIViewController *)
   参数为空，表示使用当前控制器作为展示结果的控制器。否则，使用指定的控制器作为显示结果的控制器

2. 两个代理
   (1) UISearchControllerDelegate该代理中的方法用来告知用户结果视图的状态（即将出现，已经出现，即将消失，已经消失）；
   (2) UISearchResultsUpdating 该代理中updateSearchResultsForSearchController方法每输入一个字符就会执行该方法一次，在此方法中进行数据的更新及表视图的刷新

3. 属性

// active 属性就是当前 searchController 是不是处于激活状态.只要点击 searchBar,active 就会被置为 true.
@property (nonatomic, assign, getter = isActive) BOOL active;

// 搜索框，根据需求可进行自定义
@property (nonatomic, strong, readonly) UISearchBar *searchBar;

// 只读属性,展示结果的视图控制器
@property (nullable, nonatomic, strong, readonly) UIViewController *searchResultsController;

// 搜索时，背景是否变暗色 ，默认为YES
@property (nonatomic, assign) BOOL dimsBackgroundDuringPresentation
  
// 搜索时，背景是否变模糊 默认为YES
@property (nonatomic, assign) BOOL obscuresBackgroundDuringPresentation NS_AVAILABLE_IOS(9_1);

// 是否隐藏导航栏，默认为YES
@property (nonatomic, assign) BOOL hidesNavigationBarDuringPresentation; 

4. 个性化设置

// 通过此种方式可以获取到searchBar内部的输入框，根据需要可对其进行个性化设置
UITextField *searchTextField = [self.systemSearchController.searchBar valueForKey:@"_searchField"];

三、代理

1. UISearchControllerDelegate

//当自动呈现或删除发生时，调用这些方法。如果自己呈现或取消搜索控制器，它们将不会被调用。
- (void)willPresentSearchController:(UISearchController *)searchController;
- (void)didPresentSearchController:(UISearchController *)searchController;
- (void)willDismissSearchController:(UISearchController *)searchController;
- (void)didDismissSearchController:(UISearchController *)searchController;

// 在搜索控制器的搜索栏同意开始编辑或“active”被设置为YES时调用。如果您选择不呈现控制器或不实现此方法，则将代表您执行默认表示。
- (void)presentSearchController:(UISearchController *)searchController;

四、使用系统搜索控制器所遇到的坑及解决方式

1、搜索结果页tableView向下偏移，如图：

tableView向下偏移

解决方法：

第一个界面添加：

self.definesPresentationContext = YES;

第二个界面添加：

self.edgesForExtendedLayout =UIRectEdgeNone;

2. warning 如果进入预编辑状态,searchBar消失(UISearchController套到�TabBarController可能会出现这个情况),请添加下边这句话

   self.definesPresentationContext = YES;

3. iOS11之后searchController有了新样式，可以放在导航栏

   if (@available(iOS 11.0, *)) {
       self.navigationItem.searchController = self.searchController;
   } else {
       self.tableView.tableHeaderView = self.searchController.searchBar;
   }

4. 在iOS 11上运行tableView向下偏移64px或者20px，因为iOS 11废弃了automaticallyAdjustsScrollViewInsets，而是给UIScrollView增加了contentInsetAdjustmentBehavior属性。避免这个坑的方法是要判断

if (@available(iOS 11.0, *)) {
_tableView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
}else {
self.automaticallyAdjustsScrollViewInsets = NO;
}