以前在做搜索框时都是自己写代码实现的，最近产品提的一个需求上面的搜索框和系统的特别相似，就寻思着可以用系统提供的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上。
