UISearchBar 是列表頁的標配。它封裝了輸入框、取消按鈕、書籤按鈕、範圍選擇條等一整套元素,屬性數量可觀。本文按「外觀 → 按鈕 → 範圍條 → 協議 → 數據篩選」的順序做一次系統梳理。
UISearchBar *search = [[UISearchBar alloc] initWithFrame:CGRectMake(0, 44, 320, 120)];
// 控件風格:0 為默認(淺色),1 為黑色風格 search.barStyle = UIBarStyleDefault; // 三種 searchBarStyle // UISearchBarStyleDefault 系統默認 // UISearchBarStyleProminent 用於 Mail、信息、聯繫人,不提供默認背景色/圖,需自行定制 // UISearchBarStyleMinimal 用於日曆、備忘錄、音樂 search.searchBarStyle = UISearchBarStyleDefault; search.text = @"HMT"; // 已輸入的文本 search.prompt = @"DOTA"; // 頂部單行提示文字 search.placeholder = @"請輸入要搜索的詞語"; // 半透明佔位文字,輸入後消失 // tintColor:影響閃動光標、選中範圍邊框、取消按鈕等(帶漸變效果) search.tintColor = [UIColor redColor]; // barTintColor:只改搜索框本身的底色,不影響其他控件配色 search.barTintColor = [UIColor whiteColor]; search.translucent = YES; // 是否使用半透明毛玻璃效果
自動大寫策略:
// UITextAutocapitalizationTypeNone 除非手動切換,否則不大寫 // UITextAutocapitalizationTypeWords 每個單詞首字母大寫 // UITextAutocapitalizationTypeSentences 每句首字母大寫 // UITextAutocapitalizationTypeAllCharacters 全部大寫 search.autocapitalizationType = UITextAutocapitalizationTypeNone; // 自動校正:Default / No / Yes search.autocorrectionType = UITextAutocorrectionTypeNo; // 鍵盤樣式 search.keyboardType = UIKeyboardTypeNumberPad;
search.showsBookmarkButton = YES; // 顯示書籤按鈕
[search setShowsCancelButton:YES animated:YES]; // 動畫顯示取消按鈕
search.showsSearchResultsButton = YES; // 顯示搜索結果按鈕
// 自定義按鈕圖標
[search setImage:[UIImage imageNamed:@"qiyi.png"]
forSearchBarIcon:UISearchBarIconResultsList
state:UIControlStateNormal];
// 數組元素即各個按鈕的標題 search.scopeButtonTitles = [NSArray arrayWithObjects:@"iOS", @"Android", @"iPhone", nil]; // 進入界面時默認選中的索引 search.selectedScopeButtonIndex = 2; // 是否顯示範圍條。注意:顯示後需要相應加高 search 的 frame, // 否則會被裁切(不顯示時 80 左右的高度通常夠用) search.showsScopeBar = YES;
search.backgroundImage = [UIImage imageNamed:@"qiyi.png"]; // 整體背景 search.scopeBarBackgroundImage = [UIImage imageNamed:@"qiyi.png"]; // 範圍條背景
// 即將成爲第一響應者,返回 NO 可阻止進入編輯
- (BOOL)searchBarShouldBeginEditing:(UISearchBar *)searchBar;
// 開始編輯時調用
- (void)searchBarTextDidBeginEditing:(UISearchBar *)searchBar {
[searchBar setShowsCancelButton:YES animated:YES]; // 動畫顯示取消按鈕
}
// 即將結束編輯,返回 NO 可阻止放棄第一響應者
- (BOOL)searchBarShouldEndEditing:(UISearchBar *)searchBar;
// 結束編輯
- (void)searchBarTextDidEndEditing:(UISearchBar *)searchBar;
// 文本變化時調用(包括清空)。非常有用,可實現實時搜索
- (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText;
// 文本即將變化前調用,可在此攔截並修改
- (BOOL)searchBar:(UISearchBar *)searchBar shouldChangeTextInRange:(NSRange)range
replacementText:(NSString *)text;
- (void)searchBarSearchButtonClicked:(UISearchBar *)searchBar; // 點擊鍵盤搜索鍵
- (void)searchBarBookmarkButtonClicked:(UISearchBar *)searchBar; // 點擊書籤按鈕
- (void)searchBarResultsListButtonClicked:(UISearchBar *)searchBar; // 點擊結果列表按鈕
- (void)searchBarCancelButtonClicked:(UISearchBar *)searchBar {
[searchBar setShowsCancelButton:NO animated:NO]; // 收回取消按鈕
[searchBar resignFirstResponder]; // 收盤並結束搜索
}
// 範圍選擇條切換
- (void)searchBar:(UISearchBar *)searchBar
selectedScopeButtonIndexDidChange:(NSInteger)selectedScope;
// 假設
NSArray *array = [[NSArray alloc] initWithObjects:@"luna", @"moon", @"", @"lion", @"coco", nil];
- (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText
{
// 寫法一:[cd] 表示同時忽略大小寫與發音音符
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF CONTAINS[cd] %@", searchText];
// 數組自帶的快速遍歷接口,返回類型為 NSArray
NSLog(@"%@", [array filteredArrayUsingPredicate:predicate]);
// 寫法二:手動遍歷並逐個判定
for (int i = 0; i < array.count; i++) {
if ([predicate evaluateWithObject:[array objectAtIndex:i]]) {
NSLog(@"%@", [array objectAtIndex:i]);
}
}
}
filteredArrayUsingPredicate: 一行搞定,是首選;evaluateWithObject: 則適合需要在篩選的同時做別的事(例如同步更新索引)的場景。
寫搜索功能時有三個體驗細節值得留意:一是把 searchBarSearchButtonClicked: 裡記得調用 resignFirstResponder,否則鍵盤不會收起;二是實時搜索要在 textDidChange: 中做防抖(debounce),避免每次擊鍵都觸發請求或全量過濾;三是若使用 searchController(iOS 8 之後的推薦方式),上述大部分配置都可以通過 UISearchController 的屬性完成,並且能自動處理與滾動視圖的互斥、鍵盤遮擋等問題,比直接佈置 UISearchBar 省心不少。