您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS UISearchBar 搜索欄組件屬性與用法整理

編輯:iOS 開發綜合

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];

四、範圍選擇條(Scope Bar)

// 數組元素即各個按鈕的標題
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"];  // 範圍條背景

六、UISearchBarDelegate 協議方法

編輯相關

// 即將成爲第一響應者,返回 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;

七、用 NSPredicate 做數據篩選

// 假設
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 省心不少。

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