UISearchController 是 iOS 8 之後提供的搜索控制器,它能把搜索框與列表、導覽列自然地整合在一起,省去手動佈局與事件管理的麻煩。本文以「添加朋友」頁面為例,示範如何用它做即時過濾。
把 searchBar 作為 tableHeaderView,指定 searchResultsUpdater,並關閉彈出時的背景變暗與導覽列隱藏,讓搜索體驗更順暢。
- (void)initSearchBar {
self.mySearchController = [[UISearchController alloc] initWithSearchResultsController:nil];
self.mySearchController.searchBar.frame = CGRectMake(100, 10, 200, 44);
self.myTableViewW.tableHeaderView = self.mySearchController.searchBar;
[self.mySearchController.searchBar sizeToFit];
self.mySearchController.searchResultsUpdater = self;
self.mySearchController.dimsBackgroundDuringPresentation = NO;
self.mySearchController.hidesNavigationBarDuringPresentation = NO;
self.mySearchController.searchBar.placeholder = @"輸入赤兔ID或者昵稱查詢";
[self presentViewController:self.mySearchController animated:YES completion:nil];
}
- (void)viewWillAppear:(BOOL)animated {
[super viewWillAppear:animated];
[self setTabBarHidden:YES withAnimation:YES];
}
- (void)viewWillDisappear:(BOOL)animated {
[super viewWillDisappear:animated];
[self.mySearchController.searchBar setHidden:YES];
[self setTabBarHidden:NO withAnimation:YES];
}
- (void)viewDidLoad {
[super viewDidLoad];
[self setExtraCellLineHidden:self.myTableViewW];
[self initCellInfo];
[self initTableView];
[self initTitleBar];
[self initHeader];
[self initSearchBar];
}
- (BOOL)textFieldShouldReturn:(UITextField *)textField {
[textField resignFirstResponder];
return YES;
}
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
[self hiddenkeyBoard];
}
- (void)hiddenkeyBoard {
[self.myTextField resignFirstResponder];
}
-(BOOL)searchBarShouldEndEditing:(UISearchBar *)searchBar {
[searchBar endEditing:YES];
return YES;
}
-(void)searchBarSearchButtonClicked:(UISearchBar *)searchBar {
[searchBar endEditing:YES];
}
為了示範方便,這裡用本地寫死的三個聯絡人資料,同時把昵稱與 ID 拆成獨立陣列,方便後續做關鍵字過濾。
- (void)initCellInfo {
NSMutableArray *cellInfoArray = [[NSMutableArray alloc] init];
NSMutableArray *nickNameArray = [[NSMutableArray alloc] init];
NSMutableArray *IDArray = [[NSMutableArray alloc] init];
CellInfo_t *cellInfo = [self newCellInfo];
cellInfo.image = @"https://b.hiphotos.baidu.com/image/w%3D310/sign=a0eb5ed6d52a60595210e71b1835342d/2fdda3cc7cd98d10f00dbe2e233fb80e7aec90d0.jpg";
cellInfo.nickName = @"呱呱呱";
cellInfo.ID = @"1";
[cellInfoArray addObject:cellInfo];
[nickNameArray addObject:cellInfo.nickName];
[IDArray addObject:cellInfo.ID];
cellInfo = [self newCellInfo];
cellInfo.image = @"https://c.hiphotos.baidu.com/image/w%3D310/sign=4632f6f379cb0a4685228d385b62f63e/902397dda144ad341343938ed2a20cf431ad853e.jpg";
cellInfo.nickName = @"任溶溶";
cellInfo.ID = @"2";
[cellInfoArray addObject:cellInfo];
[nickNameArray addObject:cellInfo.nickName];
[IDArray addObject:cellInfo.ID];
cellInfo = [self newCellInfo];
cellInfo.image = @"https://tao.goulew.com/users/upfile/201403/20140305222531big.jpg";
cellInfo.nickName = @"小安江湖";
cellInfo.ID = @"3";
[cellInfoArray addObject:cellInfo];
[nickNameArray addObject:cellInfo.nickName];
[IDArray addObject:cellInfo.ID];
cellInfo = [self newCellInfo];
cellInfo.image = @"https://d.hiphotos.baidu.com/image/w%3D310/sign=4276550c5e6034a829e2be80fb1249d9/d000baa1cd11728b9c43502fcafcc3cec3fd2c55.jpg";
cellInfo.nickName = @"路見不平";
cellInfo.ID = @"4";
[cellInfoArray addObject:cellInfo];
[nickNameArray addObject:cellInfo.nickName];
[IDArray addObject:cellInfo.ID];
self.nickNameArray = nickNameArray;
self.cellInfoArray = cellInfoArray;
self.IDArray = IDArray;
}
- (CellInfo_t *)newCellInfo {
CellInfo_t *info = [CellInfo_t new];
return info;
}
關鍵在於根據 mySearchController.active 判斷當前顯示的是搜索結果還是完整列表。
- (void)initTableView {
self.myTableViewW.delegate = self;
self.myTableViewW.dataSource = self;
}
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
if (self.mySearchController.active) {
return self.searchList.count;
} else {
return self.cellInfoArray.count;
}
}
- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
return 80;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
CellInfo_t *cellInfo = [self getCellInfo:indexPath.row];
static NSString *cellID = @"RRAddFriendCell";
RRAddFriendCell *cell = [tableView dequeueReusableCellWithIdentifier:cellID];
if (cell == nil) {
cell = [[[NSBundle mainBundle] loadNibNamed:cellID owner:self options:nil] lastObject];
}
if (self.mySearchController.active) {
cell.mynickName = self.searchList[indexPath.row];
} else {
PAImageView *image = [[PAImageView alloc] initWithFrame:cell.myimage.bounds
backgroundProgressColor:[UIColor lightGrayColor]
progressColor:nil
image:nil];
[cell.myimage addSubview:image];
[image setImageURL:cellInfo.image];
cell.mynickName = cellInfo.nickName;
cell.myID = cellInfo.ID;
}
[cell.myapplyAdd setTitle:@"申請添加" forState:UIControlStateNormal];
[cell.myapplyAdd addTarget:self action:@selector(applyAdd) forControlEvents:UIControlEventTouchUpInside];
cell.selectionStyle = UITableViewCellSelectionStyleNone;
return cell;
}
updateSearchResultsForSearchController: 會在每次輸入變化時被呼叫。這裡用 NSPredicate 的 CONTAINS[c] 做不區分大小寫的包含匹配,比對昵稱陣列後刷新列表。
- (void)updateSearchResultsForSearchController:(UISearchController *)searchController {
NSString *searchString = self.mySearchController.searchBar.text;
// 用 predicateWithFormat 建立謂詞,nickName 作為比對路徑
NSPredicate *preicate = [NSPredicate predicateWithFormat:@"SELF CONTAINS[c] %@", searchString];
if (self.searchList != nil) {
[self.searchList removeAllObjects];
}
// 過濾資料
self.searchList = [NSMutableArray arrayWithArray:[self.nickNameArray filteredArrayUsingPredicate:preicate]];
[self.myTableViewW reloadData];
}
最後別忘了用一個空的 tableFooterView 把多餘的分隔線藏起來,這是小細節,但對視覺整潔度影響不小。
- (void)setExtraCellLineHidden:(UITableView *)tableView {
UIView *view = [[UIView alloc] init];
view.backgroundColor = [UIColor clearColor];
[tableView setTableFooterView:view];
[tableView setTableHeaderView:view];
}