iOS——UISearchController（地图联想搜索Demo）
简介
UISearchController是iOS 8 之后推出的一个新的控件, 用于创建搜索条, 及管理搜索事件, 使用这个, 我们可以很容易的创建属于自己的搜索框。搜索框在app开发中是非常常见的，比如说我们要搜索一个地点。这里就利用到了这个控件，简单记录一下。
简单使用
我们就以上面这个Demo举例实现一个简单的UISearchViewController的使用。
UISearchController 让用户在 UISearchBar 上输入搜索关键词，展示搜索结果或者进行其他操作。UISearchController 把两个控制器(UIViewController)连在一起。父控制器放置 UISearchBar 控件。当用户点击搜索框时，UISearchBar 会移到屏幕顶部；输入搜索关键词，UISearchBar 下面出现子控制器的view。
所以UISearchController是很少单独使用的，一般都是配合其他的控件进行使用，实现联想搜索结果的展示栏一般是使用UITableView实现的。
控件属性
// 初始化方法, 参数是展示搜索结果的控制器, 如果是在当前控制器展示搜索结果, 就传nil
- (instancetype)initWithSearchResultsController:(nullable UIViewController *)searchResultsController;
// 负责更新搜索结果的代理, 需要遵循 UISearchResultsUpdating 协议
@property (nullable, nonatomic, weak) id <UISearchResultsUpdating> searchResultsUpdater;
// 搜索控制器是否是活跃状态, 当在一个控制器展示搜索结果的时候, 可以此来判断返回的数据源
@property (nonatomic, assign, getter = isActive) BOOL active;
// 控制器代理 遵循 UISearchControllerDelegate协议
@property (nullable, nonatomic, weak) id <UISearchControllerDelegate> delegate;
// 当搜索框激活时, 是否添加一个透明视图
@property (nonatomic, assign) BOOL dimsBackgroundDuringPresentation __TVOS_PROHIBITED;
@property (nonatomic, assign) BOOL obscuresBackgroundDuringPresentation NS_AVAILABLE_IOS(9_1); // default is YES
// 当搜索框激活时, 是否隐藏导航条
@property (nonatomic, assign) BOOL hidesNavigationBarDuringPresentation; // default is YES
@property (nullable, nonatomic, strong, readonly) UIViewController *searchResultsController;
@property (nonatomic, strong, readonly) UISearchBar *searchBar;
这里注意： UISearchController 在使用的时候, 需要设置为全局的变量或者控制器属性, 使其生命周期与控制器相同; 如果设置为局部变量, 会提前销毁, 导致无法使用.
创建Demo的一些属性
这里的采用了高德的搜索SDK——高德开发手册
//
// SearchViewController.h
// ShareParking
//
// Created by 差不多先生 on 2022/3/26.
//
#import <UIKit/UIKit.h>
#import <AMapSearchKit/AMapSearchKit.h>
#import <MAMapKit/MAMapKit.h>
NS_ASSUME_NONNULL_BEGIN
@interface SearchViewController : UIViewController <UITableViewDelegate, UITableViewDataSource, UISearchResultsUpdating, AMapSearchDelegate>
@property (nonatomic, strong) UITableView *tableView;
@property (nonatomic, strong) UISearchController *searchController;
// 数据源数组
@property (nonatomic, strong) NSMutableArray *datas;
// 搜索结果数组
@property (nonatomic, strong) NSMutableArray *results;
// 搜索接口
@property (nonatomic, strong) AMapSearchAPI* search;
@property (nonatomic, retain) MAUserLocation* currentLocation;
// 搜索字段
@property (nonatomic, strong) NSString* searchString;
@end
NS_ASSUME_NONNULL_END
首先我们要继承UISearchResultsUpdating协议。
初始化位置
这里因为我们默认搜索类型是停车场，所以初始化数据时，会自动检索当前位置附近的停车场。
以下是使用高德获取的数据。
(void)getParking {
_searchString = @"停车场";
_datas = [[NSMutableArray alloc] init];
self.search = [[AMapSearchAPI alloc] init];
self.search.delegate = self;
AMapPOIAroundSearchRequest *request = [[AMapPOIAroundSearchRequest alloc] init];
//当前位置
request.location = [AMapGeoPoint locationWithLatitude:34.15408339 longitude:108.90631727];
request.keywords = _searchString;
/* 按照距离排序. */
request.sortrule = 0;
request.requireExtension = YES;
// 启动任务
[self.search AMapPOIAroundSearch:request];
}
- (void)onPOISearchDone:(AMapPOISearchBaseRequest *)request response:(AMapPOISearchResponse *)response {
int j = 0;
if(response.pois.count == 0) {
NSLog(@"111");
return;
}
//通过 AMapPOISearchResponse 对象处理搜索结果
[self.datas removeAllObjects];
//解析response获取POI信息，具体解析见 Demo
for (AMapPOI *p in response.pois) {
j = 0;
for (int i = 0; i < _datas.count; i++) {
AMapPOI* a = _datas[i];
if ([p.name isEqual:a.name]) {
j = 1;
}
}
if (j == 0) {
//搜索结果存在数组
[self.datas addObject:p];
}
}
dispatch_async(dispatch_get_main_queue(), ^{
// UI更新代码
[self.tableView reloadData];
});
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
// 这里通过searchController的active属性来区分展示数据源是哪个
if (self.searchController.active) {
return self.results.count ;
}
return self.datas.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"cellID"];
if (cell == nil) {
cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"cellID"];
}
if ([_datas[0] class] == [AMapPOI class]) {
AMapPOI *p = self.datas[indexPath.row];
cell.textLabel.text = p.name;
} else {
AMapTip* p = self.datas[indexPath.row];
cell.textLabel.text = p.name;
}
return cell;
}
就可以达成这样一个效果。
利用SearchBar进行搜索
这里我们需要将SearchBar加入tableView最上面的位置。
// 创建UISearchController, 这里使用当前控制器来展示结果
UISearchController *search = [[UISearchController alloc]initWithSearchResultsController:nil];
// 设置结果更新代理
search.searchResultsUpdater = self;
[self getParking];
// 因为在当前控制器展示结果, 所以不需要这个透明视图
search.dimsBackgroundDuringPresentation = NO;
self.searchController = search;
// 将searchBar赋值给tableView的tableHeaderView
search.searchBar.placeholder = @"选择停车位位置";
self.tableView.tableHeaderView = search.searchBar;
接下来我们需要调用协议方法：
这个方法会在我们输入时调用，我们可以在这里根据输入文字重新搜索位置，并且刷新tableView的数据。
// 输入响应函数
- (void)updateSearchResultsForSearchController:(UISearchController *)searchController {
_searchString = searchController.searchBar.text;
[self inputAddress];
}
- (void)inputAddress {
AMapInputTipsSearchRequest *tips = [[AMapInputTipsSearchRequest alloc] init];
tips.keywords = _searchString;
tips.city = @"西安";
tips.cityLimit = YES;
[self.search AMapInputTipsSearch:tips];
}
/* 输入提示回调. */
- (void)onInputTipsSearchDone:(AMapInputTipsSearchRequest *)request response:(AMapInputTipsSearchResponse *)response {
if(response.count == 0) {
NSLog(@"111");
return;
} else {
[_datas removeAllObjects];
for (int i = 0; i < response.count; i++) {
AMapTip* p = response.tips[i];
[_datas addObject:p];
}
}
dispatch_async(dispatch_get_main_queue(), ^{
// UI更新代码
[self.tableView reloadData];
});
}
//@interface AMapTip : AMapSearchObject
/poi的id
//@property (nonatomic, copy) NSString *uid;
/名称
//@property (nonatomic, copy) NSString *name;
/区域编码
//@property (nonatomic, copy) NSString *adcode;
/所属区域
//@property (nonatomic, copy) NSString *district;
/地址
//@property (nonatomic, copy) NSString *address;
/位置
//@property (nonatomic, copy) AMapGeoPoint *location;
/类型码, since 4.5.0. 对应描述可下载参考官网文档 http://a.amap.com/lbs/static/zip/AMap_API_Table.zip。
//@property (nonatomic, copy) NSString *typecode;
- (void)onPOISearchDone:(AMapPOISearchBaseRequest *)request response:(AMapPOISearchResponse *)response {
int j = 0;
if(response.pois.count == 0) {
NSLog(@"111");
return;
}
//通过 AMapPOISearchResponse 对象处理搜索结果
[self.datas removeAllObjects];
//解析response获取POI信息，具体解析见 Demo
for (AMapPOI *p in response.pois) {
j = 0;
for (int i = 0; i < _datas.count; i++) {
AMapPOI* a = _datas[i];
if ([p.name isEqual:a.name]) {
j = 1;
}
}
if (j == 0) {
//搜索结果存在数组
[self.datas addObject:p];
}
}
dispatch_async(dispatch_get_main_queue(), ^{
// UI更新代码
[self.tableView reloadData];
});
}
然后就可以实现联想搜索地点了，这个控件这里用的比较简单，后面如果深入使用会来补充的。
