[iOS学习]之UISearchController简单使用

在 iOS 8.0 之前实现搜索功能我们用的是 UISearchBar 和UISearchDisplayController，但是在 iOS 8.0 之后上述方法已经被弃用，因此本篇文章用 UISearchController 实现基本的搜索功能。本文的代码在我的 GitHub 上下载!

如何使用 UISearchController

1. 初始化 UISearchController
2. 遵守 UISearchResultsUpdating 协议
3. 实现协议方法

初始化 UISearchController

// 如果你希望搜索结果在当前视图显示，searchResultsController 设为 nil，否则传入新的视图控制器
- (instancetype)initWithSearchResultsController:(nullable UIViewController *)searchResultsController;

遵守 UISearchResultsUpdating 协议, 实现搜索展示功能

// 当改变或调用 SearchBar 时调用
– (void)updateSearchResultsForSearchController:(UISearchController *)searchController;

Demo

下面用实际案例来操作一遍。

在原本控制器展示结果

首先声明和定义属性

@interface ADSourceVC () <UISearchResultsUpdating, UITableViewDelegate, UITableViewDataSource, UISearchControllerDelegate, UISearchBarDelegate>

@property (nonatomic, strong) UISearchController *searchController;
/** 要搜索的数据源 */
@property (nonatomic, strong) NSArray *dataList;
/** 搜索结果数据源 */
@property (nonatomic, strong) NSMutableArray *searchList;
@end

初始化 UISearchController

#pragma mark - Lazy Load
- (UISearchController *)searchController {
    if (_searchController == nil) {
        // searchResultsController为nil时,表示在当前控制器显示搜索结果
        _searchController = [[UISearchController alloc] initWithSearchResultsController:nil];
        // 搜索栏的占位内容
        _searchController.searchBar.placeholder = @"请输入搜索内容";
        // 遵守协议
        self.searchController.searchResultsUpdater = self;
        self.searchController.delegate = self;
        self.searchController.searchBar.delegate = self;
        [self.searchController.searchBar sizeToFit];

        self.definesPresentationContext = YES;
        // 是否添加半透明覆盖
        self.searchController.obscuresBackgroundDuringPresentation = NO;
        // 在搜索过程中是否隐藏了底层内容(使用obscuresBackgroundDuringPresentation代替)
//    self.searchController.dimsBackgroundDuringPresentation = NO;
        // 在搜索时是否应该隐藏导航栏
        self.searchController.hidesNavigationBarDuringPresentation = YES;
        self.tableView.tableHeaderView = self.searchController.searchBar;
    }
    return _searchController;
}

实现代理方法

#pragma mark - <UITableViewDataSource>
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return self.searchController.active ? self.searchList.count : self.dataList.count;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    static NSString *str = @"cell";
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:str];
    if (!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:str];
    }
    NSArray *datas = self.searchController.active ? self.searchList : self.dataList;
    cell.textLabel.text = datas[indexPath.row];
    return cell;
}

#pragma mark - <UISearchResultsUpdating>
// 搜索时触发的方法
- (void)updateSearchResultsForSearchController:(UISearchController *)searchController {
    NSString *searchStr = self.searchController.searchBar.text;
    // 谓词
    NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF CONTAINS %@", searchStr];

    // 过滤数据
    self.searchList = [NSMutableArray arrayWithArray:[self.dataList filteredArrayUsingPredicate:predicate]];

    // 刷新列表
    [self.tableView reloadData];
}

在新的控制器展示结果

如果我们想要在新的控制器中展示结果，在初始化 UISearchController 的时候指定展示的控制器即可。然后在新控制器中设置新样式即可。

// 搜索结果控制器
ADSearchResultTVC *resultTvc = [[ADSearchResultTVC alloc] init];

// UISearchController初始化
_searchController = [[UISearchController alloc] initWithSearchResultsController:resultTvc];

原文地址:http://blog.qiji.tech/archives/6736#i-3