iOS开发——UI进阶篇（十九）UISearchBar控件简介

最近用到搜索功能。总结一下

搜索，无疑可以使用UISearchBar控件！

那就先了解一下UISearchBar控件吧！

UISearchBar控件就是要为你完成搜索功能的一个专用控件。它集成了很多你意想不到的功能和特点！

首先，还是来普及一下UISearchBar控件API相关的属性和方法吧！

UISearchBar属性相关

_searchBar = [[UISearchBar alloc] initWithFrame:CGRectZero];// 初始化，不解释
    [self.searchBar setPlaceholder:@"Search"];// 搜索框的占位符
    [self.searchBar setPrompt:@"Prompt"];// 顶部提示文本,相当于控件的Title
    [self.searchBar setBarStyle:UIBarMetricsDefault];// 搜索框样式
    [self.searchBar setTintColor:[UIColor blackColor]];// 搜索框的颜色，当设置此属性时，barStyle将失效
    [self.searchBar setTranslucent:YES];// 设置是否透明
    [self.searchBar setBackgroundImage:[UIImage imageNamed:@"image0"]];// 设置背景图片
    [self.searchBar setSearchFieldBackgroundImage:[UIImage imageNamed:@"image3"] forState:UIControlStateNormal];// 设置搜索框中文本框的背景
    [self.searchBar setSearchFieldBackgroundImage:[UIImage imageNamed:@"image0"] forState:UIControlStateHighlighted];
    [self.searchBar setSearchFieldBackgroundPositionAdjustment:UIOffsetMake(, )];// 设置搜索框中文本框的背景的偏移量
 
    [self.searchBar setSearchResultsButtonSelected:NO];// 设置搜索结果按钮是否选中
    [self.searchBar setShowsSearchResultsButton:YES];// 是否显示搜索结果按钮
 
    [self.searchBar setSearchTextPositionAdjustment:UIOffsetMake(, )];// 设置搜索框中文本框的文本偏移量
 
    [self.searchBar setInputAccessoryView:_btnHide];// 提供一个遮盖视图
    [self.searchBar setKeyboardType:UIKeyboardTypeEmailAddress];// 设置键盘样式
 
    // 设置搜索框下边的分栏条
    [self.searchBar setShowsScopeBar:YES];// 是否显示分栏条
    [self.searchBar setScopeButtonTitles:[NSArray arrayWithObjects:@"Singer",@"Song",@"Album", nil]];// 分栏条，栏目
    [self.searchBar setScopeBarBackgroundImage:[UIImage imageNamed:@"image3"]];// 分栏条的背景颜色
    [self.searchBar setSelectedScopeButtonIndex:];// 分栏条默认选中的按钮的下标
 
    [self.searchBar setShowsBookmarkButton:YES];// 是否显示右侧的“书图标”
 
    [self.searchBar setShowsCancelButton:YES];// 是否显示取消按钮
    [self.searchBar setShowsCancelButton:YES animated:YES];
 
    // 是否提供自动修正功能（这个方法一般都不用的）
    [self.searchBar setSpellCheckingType:UITextSpellCheckingTypeYes];// 设置自动检查的类型
    [self.searchBar setAutocorrectionType:UITextAutocorrectionTypeDefault];// 是否提供自动修正功能，一般设置为UITextAutocorrectionTypeDefault
 
    self.searchBar.delegate = self;// 设置代理
    [self.searchBar sizeToFit];
    myTableView.contentInset = UIEdgeInsetsMake(CGRectGetHeight(self.searchBar.bounds), , , );
 
    [self.view addSubview:myTableView];
 
    [myTableView addSubview:self.searchBar];

属性有点多，需要多捣鼓两遍

绝大多部分都是定义一些外观的东西！了解了各个属性，一定能满足你设计出你想要的外观效果！！

然后，解释一下，我个人觉的比较有趣和重要的属性！

1.@property (nonatomic, readwrite, retain) UIView *inputAccessoryView;属性

例如：

[self.searchBar setInputAccessoryView:your_View];// 提供一个遮盖视图

当处于UISearchBar焦点状态下（输入框正要输入内容时），会有一个遮盖视图。

你翻看一下，iPhone手机上的电话本搜索功能。那个遮盖视图就是一个半透明的黑色View。

查看了一下API，是iOS 6.0 以及以后，新加入的！
那么就意味这 iOS 6.0 之前的系统是不兼容的。那么怎么才能达到这个类似的效果呢？
变通一下，其实，很简单：仍然设置一个按钮，初始状态下，该UIButton控件透明度设置为0；并且在控件取得焦点时，设置透明度为1。
小技巧：如果要设置这个属性，那么，就最好定义一个UIButton控件，这样，当点击该遮盖层的话，可以利用按钮事件，
设置：[self.searchBar resignFirstResponder];让搜索框放弃第一焦点。（iPhone电话薄也是这么做的，感觉很人性化）。

迷惑：还有一个小的问题：当我让UISearchBar显示取消按钮时，当我让UISearchBar失去焦点时，我的取消按钮也不能点击了。衰啊。
看了一下iPhone电话薄的UISearchBar，竟然可以也，找了很久，都不知道是怎么回事，大概苹果又开始玩私有API了吧。
解决方法：很暴力，但是很好用！在UISearchBar上原来取消按钮的位置上覆盖一个UIButton，设置成一样的。呵呵。可以了。

类似如下：

// 遮盖层
_btnAccessoryView=[[UIButton alloc] initWithFrame:CGRectMake(, , BOUNDS_WIDTH, BOUNDS_HEIGHT)];
[_btnAccessoryView setBackgroundColor:[UIColor blackColor]];
[_btnAccessoryView setAlpha:0.0f];
[_btnAccessoryView addTarget:self action:@selector(ClickControlAction:) forControlEvents:UIControlEventTouchUpInside];
[self.view addSubview:_btnAccessoryView];
 
// 遮罩层（按钮）-点击处理事件
- (void) ClickControlAction:(id)sender{
    NSLog(@"handleTaps");
 
    [self controlAccessoryView:];
 
}
 
// 控制遮罩层的透明度
- (void)controlAccessoryView:(float)alphaValue{
 
    [UIView animateWithDuration:0.2 animations:^{
        //动画代码
        [self.btnAccessoryView setAlpha:alphaValue];
    }completion:^(BOOL finished){
        if (alphaValue<=) {
            [self.searchBar resignFirstResponder];
            [self.searchBar setShowsCancelButton:NO animated:YES];
            [self.navigationController setNavigationBarHidden:NO animated:YES];
 
        }
 
    }];
}

2.@property(nonatomic,assign) id<</b>UISearchBarDelegate> delegate;属性

例如：

self.searchBar.delegate = self;

说到这个属性，就是设置委托了。

UISearchBarDelegate委托定义了很多关于，搜索框的一些操作数据的协议方法！

先来个，特写，把x协议的家庭成员列出来：

@protocol UISearchBarDelegate
 
@optional
 
- (BOOL)searchBarShouldBeginEditing:(UISearchBar *)searchBar;
- (void)searchBarTextDidBeginEditing:(UISearchBar *)searchBar;
- (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;
- (void)searchBarResultsListButtonClicked:(UISearchBar *)searchBar;
 
- (void)searchBar:(UISearchBar *)searchBar selectedScopeButtonIndexDidChange:(NSInteger)selectedScope;
 
@end

这不需要解释吧，看方法名称就能了解！

我们来看一看，常用的委托方法吧。

#pragma mark - UISearchBarDelegate 协议
 
// UISearchBar得到焦点并开始编辑时，执行该方法
- (BOOL)searchBarShouldBeginEditing:(UISearchBar *)searchBar{
    [self.searchBar setShowsCancelButton:YES animated:YES];
    [self.navigationController setNavigationBarHidden:YES animated:YES];
    [self controlAccessoryView:0.9];// 显示遮盖层。
    return YES;
 
}
 
// 取消按钮被按下时，执行的方法
- (void)searchBarCancelButtonClicked:(UISearchBar *)searchBar{
    [self.searchBar resignFirstResponder];
    [self.searchBar setShowsCancelButton:NO animated:YES];
    [liveViewAreaTable searchDataBySearchString:nil];// 搜索tableView数据
    [self.navigationController setNavigationBarHidden:NO animated:YES];
    [self controlAccessoryView:];// 隐藏遮盖层。
 
}
 
// 键盘中，搜索按钮被按下，执行的方法
- (void)searchBarSearchButtonClicked:(UISearchBar *)searchBar{
    NSLog(@"---%@",searchBar.text);
    [self.searchBar resignFirstResponder];// 放弃第一响应者
    [liveViewAreaTable searchDataBySearchString:searchBar.text];
    [self.navigationController setNavigationBarHidden:NO animated:YES];
    [self controlAccessoryView:];// 隐藏遮盖层。
 
}
 
// 当搜索内容变化时，执行该方法。很有用，可以实现时实搜索
- (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText;{
    NSLog(@"textDidChange---%@",searchBar.text);
    [liveViewAreaTable searchDataBySearchString:searchBar.text];// 搜索tableView数据
    [self controlAccessoryView:];// 隐藏遮盖层。
 
}

3.遍历UISearchBar控件的子控件，这样可以针对不同的子视图来设置外观了。

for(id subView in [self.searchBar subviews]){
        if([subView isKindOfClass:[UIButton class]]){
            UIButton *btn = (UIButton *)subView;
            [btn setTitle:@"取消"  forState:UIControlStateNormal];
        }
    }

当然，不是很全。也是入门的级别，见效了！

希望对你有所帮助！