UISearchBar 是 App 裡幾乎必備的元件。它暴露的可配置項目相當多,從樣式、提示文字、右側按鈕到底部的分類選擇欄都有對應屬性,本文把它們按功能分組整理,方便查閱。
UISearchBar *search = [[UISearchBar alloc] initWithFrame:CGRectMake(0, 44, 320, 120)]; // 控件風格:UIBarStyleDefault = 0(白色),UIBarStyleBlack = 1(黑色) search.barStyle = UIBarStyleDefault; // searchBarStyle 有三種 // UISearchBarStyleDefault 目前等同 UISearchBarStyleProminent // UISearchBarStyleProminent 郵件、資訊、聯絡人使用,本身沒有預設背景色或圖片,自定義時才會顯示 // UISearchBarStyleMinimal 日曆、備忘錄、音樂使用 search.searchBarStyle = UISearchBarStyleDefault; // 控件中顯示的文字 search.text = @"HMT"; // 顯示在頂部的單行提示文字 search.prompt = @"DOTA"; // 半透明的提示文字,開始輸入後自動消失 search.placeholder = @"請輸入要搜尋的詞語"; // bar 的顏色(帶漸變),會影響游標、選擇框邊框、取消按鈕等 search.tintColor = [UIColor redColor]; // 只影響搜尋框本身的底色,不會改動其他元件的顏色 search.barTintColor = [UIColor whiteColor]; // 是否帶半透明(毛玻璃)效果 search.translucent = YES;
// 自動大寫的時機 // UITextAutocapitalizationTypeNone 除非手動切換,否則永不大寫 // UITextAutocapitalizationTypeWords 以單詞為單位,每個單詞首字母大寫 // UITextAutocapitalizationTypeSentences 以句子為單位 // UITextAutocapitalizationTypeAllCharacters 所有字母全部大寫 search.autocapitalizationType = UITextAutocapitalizationTypeNone; // 自動校正風格 // UITextAutocorrectionTypeDefault / No / Yes search.autocorrectionType = UITextAutocorrectionTypeNo; // 鍵盤樣式 search.keyboardType = UIKeyboardTypeNumberPad;
// 是否在右端顯示書籤按鈕
search.showsBookmarkButton = YES;
// 是否顯示取消按鈕(靜態寫法)
// search.showsCancelButton = 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 的高度,不顯示時 80 就夠) search.showsScopeBar = YES;
// 控件背景圖片 search.backgroundImage = [UIImage imageNamed:@"qiyi.png"]; // 選擇欄背景圖片 search.scopeBarBackgroundImage = [UIImage imageNamed:@"qiyi.png"];
協定的方法名基本已經自明,這裡只挑幾個實務上最常寫的:
// 取得焦點、開始編輯時呼叫
- (BOOL)searchBarShouldBeginEditing:(UISearchBar *)searchBar;
- (void)searchBarTextDidBeginEditing:(UISearchBar *)searchBar {
// 動畫顯示取消按鈕
[searchBar setShowsCancelButton:YES animated:YES];
}
- (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)searchBarCancelButtonClicked:(UISearchBar *)searchBar {
[searchBar setShowsCancelButton:NO animated:NO];
[searchBar resignFirstResponder]; // 收起鍵盤,結束搜尋
}
// 點擊搜尋結果按鈕
- (void)searchBarResultsListButtonClicked:(UISearchBar *)searchBar;
// 切換分類選擇欄
- (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] 表示不區分大小寫、不區分發音音符號;[c] 只忽略大小寫;[d] 只忽略音符號
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]);
}
}
}
實務上建議把 textDidChange: 中的篩選結果直接送給 UITableView 的資料源,並搭配 searchBarSearchButtonClicked: 處理需要「送出查詢」的場景,兩者相輔相成。