初始化方法
- (instancetype)initWithSearchResultsController:(nullable UIViewController *)searchResultsController;
常用屬性
searchResultsUpdater:設(shè)置搜索結(jié)果刷新者(設(shè)置該屬性需遵守 UISearchResultsUpdating協(xié)議)
active:設(shè)置(獲纫厣獭)當(dāng)前搜索狀態(tài)
delegate:設(shè)置代理
dimsBackgroundDuringPresentation:設(shè)置是否在搜索時(shí)顯示半透明背景
hidesNavigationBarDuringPresentation:設(shè)置是否在搜索時(shí)隱藏導(dǎo)航欄
searchResultsController:搜索結(jié)果控制器
searchBar:搜索框
UISearchBar
-
常用屬性
autocapitalizationType:設(shè)置自動(dòng)大小寫樣式 tintColor:設(shè)置前景色 barTintColor:設(shè)置背景顏色 searchBarStyle:設(shè)置搜索框樣式 translucent:設(shè)置是否半透明
UISearchResultsUpdating
- UISearchResultsUpdating是一個(gè)結(jié)果刷新協(xié)議,其提供的方法如下
// 每次更新搜索框里的文字顷窒,就會(huì)調(diào)用這個(gè)方法
- (void)updateSearchResultsForSearchController:(UISearchController *)searchController;
謂詞
-
NSPredicate 創(chuàng)建謂詞
謂詞創(chuàng)建方法: +(NSPredicate *)predicateWithFormat:(NSString *)predicateFormat, ...; // 示例:創(chuàng)建一個(gè)以‘A’字母開頭的謂詞判斷 NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF BEGINSWITH [CD] %@", @"A"];
-
根據(jù)謂詞判斷在數(shù)組中進(jìn)行搜索失暂,得到結(jié)果數(shù)組的方法如下:
- (NSArray<ObjectType> *)filteredArrayUsingPredicate:(NSPredicate *)predicate;
代碼示例:
#import "ViewController.h"
static NSString *const kReusableCellIdentifier = @"identifier";
@interface ViewController () <UITableViewDelegate, UITableViewDataSource, UISearchResultsUpdating>{
NSMutableArray *_dataSource; /**< 數(shù)據(jù)源 */
NSMutableArray *_searchResults; /**< 搜索結(jié)果 */
}
@property (nonatomic, strong) UITableView *tableView; /**< 表格視圖 */
@property (nonatomic, strong) UISearchController *searchController; /**< 搜索控制器 */
- (void)initializeDataSource; /**< 初始化數(shù)據(jù)源 */
- (void)initializeUserInterface; /**< 初始化用戶界面 */
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
[self initializeDataSource];
[self initializeUserInterface];
}
#pragma mark *** Initialize methods ***
- (void)initializeDataSource {
// 初始化數(shù)據(jù)源
_dataSource = [NSMutableArray arrayWithArray:[UIFont familyNames]];
}
- (void)initializeUserInterface {
self.view.backgroundColor = [UIColor whiteColor];
// 關(guān)閉系統(tǒng)自動(dòng)偏移
self.automaticallyAdjustsScrollViewInsets = NO;
// 加載表格視圖
[self.view addSubview:self.tableView];
// 添加導(dǎo)航欄
self.tableView.tableHeaderView = self.searchController.searchBar;
}
#pragma mark *** <UITableViewDelegate, UITableViewDataSource> ***
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
// 如果用戶正在搜索瓢捉,則返回搜索結(jié)果的count逼裆,否則直接返回?cái)?shù)據(jù)源數(shù)組的count橱乱;
if (self.searchController.active) {
return _searchResults.count;
}else {
return _dataSource.count;
}
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:kReusableCellIdentifier];
if (!cell) {
cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:kReusableCellIdentifier];
}
// 如果用戶正在搜索盐欺,則返回搜索結(jié)果對(duì)應(yīng)的數(shù)據(jù),否則直接返回?cái)?shù)據(jù)數(shù)組對(duì)應(yīng)的數(shù)據(jù)仅醇;
if (self.searchController.active) {
cell.textLabel.text = _searchResults[indexPath.row];
}else {
cell.textLabel.text = _dataSource[indexPath.row];
}
return cell;
}
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
// 取消選中
[tableView deselectRowAtIndexPath:indexPath animated:YES];
if (self.searchController.active) {
NSLog(@"%@", _searchResults[indexPath.row]);
}else {
NSLog(@"%@", _dataSource[indexPath.row]);
}
// 停止搜索
self.searchController.active = NO;
}
#pragma mark *** <UISearchResultsUpdating> ***
// 每次更新搜索框里的文字冗美,就會(huì)調(diào)用這個(gè)方法
- (void)updateSearchResultsForSearchController:(UISearchController *)searchController {
// 獲取搜索框里地字符串
NSString *searchString = searchController.searchBar.text;
// 謂詞
/**
1.BEGINSWITH : 搜索結(jié)果的字符串是以搜索框里的字符開頭的
2.ENDSWITH : 搜索結(jié)果的字符串是以搜索框里的字符結(jié)尾的
3.CONTAINS : 搜索結(jié)果的字符串包含搜索框里的字符
[c]不區(qū)分大小寫[d]不區(qū)分發(fā)音符號(hào)即沒有重音符號(hào)[cd]既不區(qū)分大小寫,也不區(qū)分發(fā)音符號(hào)析二。
*/
// 創(chuàng)建謂詞
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF BEGINSWITH [CD] %@", searchString];
// 如果搜索框里有文字粉洼,就按謂詞的匹配結(jié)果初始化結(jié)果數(shù)組,否則叶摄,就用字體列表數(shù)組初始化結(jié)果數(shù)組属韧。
if (_searchResults != nil && searchString.length > 0) {
[_searchResults removeAllObjects];
_searchResults = [NSMutableArray arrayWithArray:[_dataSource filteredArrayUsingPredicate:predicate]];
} else if (searchString.length == 0) {
_searchResults = [NSMutableArray arrayWithArray:_dataSource];
}
// 刷新表格視圖
[_tableView reloadData];
}
#pragma mark *** Getters ***
- (UITableView *)tableView {
if (!_tableView) {
_tableView = [[UITableView alloc] initWithFrame:CGRectMake(0, 64, CGRectGetWidth(self.view.bounds), CGRectGetHeight(self.view.bounds) - 64) style:UITableViewStylePlain];
// 設(shè)置代理
_tableView.delegate = self;
// 設(shè)置數(shù)據(jù)源
_tableView.dataSource = self;
// 設(shè)置單元格高度
_tableView.rowHeight = 50;
}
return _tableView;
}
- (UISearchController *)searchController {
if (!_searchController) {
// 初始化搜索控制器
_searchController = [[UISearchController alloc] initWithSearchResultsController:nil];
// 設(shè)置代理
_searchController.searchResultsUpdater = self;
// 設(shè)置半透明背景,當(dāng)設(shè)置當(dāng)前視圖控制器作為搜索結(jié)果的視圖控制器時(shí)蛤吓,要設(shè)為NO宵喂;
_searchController.dimsBackgroundDuringPresentation = NO;
// 隱藏導(dǎo)航欄
_searchController.hidesNavigationBarDuringPresentation = YES;
// 關(guān)掉自動(dòng)大寫鎖定
_searchController.searchBar.autocapitalizationType = UITextAutocapitalizationTypeNone;
// 設(shè)置searchBar的frame
_searchController.searchBar.frame = CGRectMake(0, 0, CGRectGetWidth(self.view.bounds), 44);
}
return _searchController;
}
@end