以前在做搜索框时都是自己写代码实现的，最近产品提的一个需求上面的搜索框和系统的特别相似，就寻思着可以用系统提供的UISearchController来实现。刚开始在Demo上面跑发现实现起来特别简单，只需要调用几个系统API就行，但真正把代码移到工程中才发现有着特别多的坑。苹果将UISearchController高度封装，这样使用起来确实是方便很多，但同时也就没办法高度自定义，很多样式都没办法直接通过系统API直接实现。接下来记录一下遇到的坑及解决方案。

UISearchController使用

- (void)setupUI {
    _searchController = [[UISearchController alloc] initWithSearchResultsController:nil];
    _searchController.searchBar.placeholder = @"搜索问题";
    _searchController.searchResultsUpdater = self;
    _searchController.dimsBackgroundDuringPresentation = NO;
    _searchController.searchBar.tintColor = [UIColor redColor];
    
    _tableView = [[UITableView alloc] initWithFrame:self.view.bounds];
    _tableView.dataSource = self;
    _tableView.tableFooterView = [UIView new];
    [self.view addSubview:_tableView];
    
    _tableView.tableHeaderView = _searchController.searchBar;
}

取消按钮文字

使用后发现SearchCancelButton的文字是cancel，本以为这是本地化的问题，将模拟器改为简体中文后还是cancel，果然坑还是不少，可以使用KVC修改文字，也可以遍历子视图找到Button再进行修改，但是觉得这两种方法都不好，如果以后苹果爸爸改了UISearchBar的视图结构就会出问题，不过目前也没有其他方式。

[_searchController.searchBar setValue:@"取消" forKey:@"_cancelButtonText"];

TextField背景颜色

扫了一遍官方文档，发现好像还是没有提供API，心里又是一批mmp，本以为又要遍历子视图去修改，后面发现有一个API可以用。

- (void)setSearchFieldBackgroundImage:(UIImage *)backgroundImage 
                             forState:(UIControlState)state;

用这个API是可以使用的，但是需要的参数是 UIImage，需要将颜色转为UIImage。

文字居中

在iOS 11之前，UISearchBar默认是居中的，在iOS 11之后改为居左，并且没有直接的API可以设置对齐方式。系统提供了一个API可以调整搜索放大镜的位置：

- (void)setPositionAdjustment:(UIOffset)adjustment 
             forSearchBarIcon:(UISearchBarIcon)icon;

实现思路是设置放大镜的PositionAdjustment，当搜索处于激活状态再将PositionAdjustment设为Zero。

#pragma mark - UISearchControllerDelegate
- (void)willPresentSearchController:(UISearchController *)searchController {
    if (@available(iOS 11.0, *)) {
        [_searchController.searchBar setPositionAdjustment:UIOffsetMake(7, 0) forSearchBarIcon:UISearchBarIconSearch];
    }
}

- (void)willDismissSearchController:(UISearchController *)searchController {
    if (@available(iOS 11.0, *)) {
        [_searchController.searchBar setPositionAdjustment:UIOffsetZero forSearchBarIcon:UISearchBarIconSearch];
    }
}

UISearchBar添加位置

在iOS 11之前UISearchBar通常都是加在tableView的headerView上，但是iOS 11上系统可以将UISearchBar加在导航栏上，效果就和系统信息、通信录的效果一样。

self.navigationItem.searchController = _searchController;

如果在iOS 11之后也要将UISearchBar加在tableView的headerView上，就会出现偏移的问题。

iOS 11 偏移问题

在iOS 11之后也要将UISearchBar加在tableView的headerView上，点击进入搜索状态时就会出现先上移20再进行动画，退出搜索状态时也是进行完动画后再往下偏移20。
解决方案是将控制器的definesPresentationContext属性设为YES，并且导航栏的translucent必须设为NO。

self.navigationController.navigationBar.translucent = NO;
self.definesPresentationContext = YES;

设置完上面两个属性后还是有问题，需要再设置edgesForExtendedLayout：

#pragma mark - UISearchResultsUpdating
- (void)updateSearchResultsForSearchController:(UISearchController *)searchController {
    self.edgesForExtendedLayout = UIRectEdgeNone;
}

总结

系统提供的UISearchController虽然封装了大部分功能，但是自定义程度严重不足，很多调整都必须采取一些不太好的方案来实现，使用起来坑还特别多，单单偏移问题当初就困扰了我很久，某度上一直找不到合适的解决方案，最终还是在Google上找到，不得不说Google还是秒杀某度（扯远了）。总之就是UISearchController坑很多，如果产品要求的搜索框自定义程度较多最好还是自己实现吧，自己实现的时间也不会比探坑的时间长。

Demo代码还是一样放在GitHub上。