您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 開發中 UISearchBar 搜尋欄元件用法整理

編輯:iOS 相關教學

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;

三、右側按鈕與圖示(UISearchBarIcon)

// 是否在右端顯示書籤按鈕
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"];

六、UISearchBarDelegate 常用方法

協定的方法名基本已經自明,這裡只挑幾個實務上最常寫的:

// 取得焦點、開始編輯時呼叫
- (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;

七、搭配 NSPredicate 做資料篩選

// 假設原始資料
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: 處理需要「送出查詢」的場景,兩者相輔相成。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved