[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