搜索好友

搜索好友页面用于检索当前用户设备上的所有好友。进入该页面，在输入框输入关键字，IMKit SDK 就会从数据库中拉取好友信息。 IMKit 提供基于 UIKit UITableView 的搜索页面类 RCSearchFriendsViewController。

搜索好友页面一般由导航栏，搜索栏和好友列表三部分部分组成。

初始化

调用 RCSearchFriendsViewController 类的初始化方法构建搜索好友页面。 注意，您需要创建一个 RCSearchFriendsViewModel 对象， 作为RCSearchFriendsViewController 的业务逻辑处理模块。

参数说明

参数	类型	说明
viewModel	RCSearchFriendsViewModel	RCSearchFriendsViewController 的业务逻辑处理模块。 处理页面UI的配置以及好友信息的拉取。

示例代码

Objective C

RCSearchFriendsViewModel *viewModel = [[RCSearchFriendsViewModel alloc] init];
RCSearchFriendsViewController *vc = [[RCSearchFriendsViewController alloc] initWithViewModel:viewModel];
[self.navigationController pushViewController:vc animated:YES];

定制化

IMKit 搜索好友界面的样式可进行自定义修改。

自定义标题栏

IMKit 的 RCSearchFriendsViewController 使用了系统的导航栏，可用于显示页面的标题，用户通过继承RCSearchFriendsViewController ，在 viewDidLoad 方法中通过 title 属性设置标题。

示例代码

Objective C

- (void)viewDidLoad {
    [super viewDidLoad];
    self.title = @"新标题"
}

自定义搜索框

RCSearchFriendsViewController 搜索默认是搜索好友，通过设置 RCSearchFriendsViewModel 的 delegate 属性， 实现相关代理方法，自定义搜索功能。

示例代码

Objective C

RCSearchFriendsViewModel *viewModel = [[RCSearchFriendsViewModel alloc] init];
viewModel.delegate = self;
RCSearchFriendsViewController * = [[RCSearchFriendsViewController alloc] initWithViewModel:viewModel];

[self.navigationController pushViewController:contactVC animated:YES];

...

/// 配置自定义的搜索功能
- (RCSearchBarViewModel *_Nullable)willConfigureSearchBarViewModelForSearchFriendsViewModel:(RCSearchFriendsViewModel *_Nonnull)viewModel {
  //返回自定义的搜索 ViewModel
}

...

自定义搜索好友页面 Cell

1. 自定义 RCCustomCell

Objective C

@interface RCCustomCell : UITableViewCell
@property (nonatomic, strong) UILabel *titleLabel;
@property (nonatomic, strong) UILabel *contentLabel;
@end

@implementation
// Cell 绘制
@end

2.自定义 RCCustomCellViewModel

提示

自定义 CellViewModel 需要继承 RCFriendListCellViewModel。

Objective C

typedef void(^RCPermanentCellViewModelBlock)(UIViewController *);
@interface RCCustomCellViewModel : RCFriendListCellViewModel
/// 初始化
- (instancetype)initWithTitle:(NSString *)title
                     portrait:(UIImage *)portrait
                   touchBlock:(RCPermanentCellViewModelBlock)touchBlock;
@property (nonatomic, copy) NSString *title;
@property (nonatomic, strong) UIImage *portrait;
@property (nonatomic, copy) RCPermanentCellViewModelBlock touchBlock;
@end

@implementation RCCustomCellViewModel

- (instancetype)initWithTitle:(NSString *)title 
                     portrait:(UIImage *)portrait
                   touchBlock:(RCPermanentCellViewModelBlock)touchBlock{
    self = [super init];
    if (self) {
        self.title = title;
        self.portrait = portrait;
        self.touchBlock = touchBlock;
    }
    return self;
}

// 注册并自定义cell
- (UITableViewCell *)tableView:(UITableView *)tableView
         cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    NSString *cellIdentifier = @"RCCustomCellIdentifier";
    // 注册 cell
    [tableView registerClass:RCCustomCell.class forCellReuseIdentifier:cellIdentifier];
    // 返回 cell
    RCCustomCellViewModel *cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier];
    if (!cell) {
       cell = [tableView dequeueReusableCellWithIdentifier:cellIdentifier];
    }
    //修改UI
    cell.titleLabel.text = self.title;
    cell.contentLabel.text = self.detail;
    return cell;
}

@end

3. 添加 RCSearchFriendsViewModel 代理

初始化 RCSearchFriendsViewModel 对象时设置其代理：

Objective C

RCSearchFriendsViewModel *viewModel = [[RCSearchFriendsViewModel alloc] init];
viewModel.delegate = self;

4. 修改数据源

实现代理方法：

Objective C

// 好友数据源
- (NSArray *_Nullable)searchFriendsViewModel:(RCSearchFriendsViewModel *_Nonnull)viewModel
                   willLoadItemsInDataSource:(NSArray *_Nullable)dataSource; {
     // 对数据源增删改处理
        NSMutableArray *list = dataSource.mutableCopy;
        RCCustomCellViewModel *customCellVM = [[RCCustomCellViewModel alloc] initWithTitle:@"title" portrait:[UIImage imageNamed:@"newFriend"] touchBlock:^(UIViewController * vc) {
            // 点击事件
            
        }];
        [list addObject:@[customCellVM]];
        return list;

}

5.自定义点击 cell 事件

Objective C

/// 用户点击Cell事件
/// - Parameters:
///   - viewModel: viewModel
///   - viewController: viewController
///   - tableView: tableView
///   - indexPath: indexPath
///   - viewModel: CellViewModel
///   - Returns: App是否处理[YES : SDK不再处理, NO: SDK处理]
///
///   - Since:
- (BOOL)searchFriendsViewModel:(RCSearchFriendsViewModel *_Nonnull)viewModel
                viewController:(UIViewController*_Nonnull)viewController
                     tableView:(UITableView *_Nonnull)tableView
                  didSelectRow:(NSIndexPath *_Nonnull)indexPath
                 cellViewModel:(RCBaseCellViewModel *_Nonnull)cellViewModel {
}