搜索我的群组

提示

此功能在 5.12.2 版本开始支持。

搜索我的群组页面用于检索当前用户加入的群组。进入该页面，在输入框输入关键字，IMKit SDK 就会从数据库中拉取群组信息。 IMKit 提供基于 UITableView 的搜索页面类 RCSearchGroupsViewController。

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

初始化

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

参数说明

参数	类型	说明
viewModel	RCSearchGroupsViewModel	RCSearchGroupsViewController 的业务逻辑处理模块。 处理页面UI的配置以及群组信息的拉取。

示例代码

Objective C

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

定制化

IMKit 搜索我的群组界面的样式可进行自定义修改。

自定义标题栏

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

Objective C

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

自定义搜索框

RCSearchGroupsViewController 默认按照群组名称搜索群组，通过设置 RCSearchGroupsViewModel 的 delegate 属性，实现自定义搜索代理方法来自定义搜索功能。

示例代码

Objective C

RCSearchGroupsViewModel *viewModel = [[RCSearchGroupsViewModel alloc] init];
viewModel.delegate = self;
RCSearchGroupsViewController *vc = [[RCSearchGroupsViewController alloc] initWithViewModel:viewModel];

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

...

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

...

自定义我的群组 Cell

1. 自定义 RCCustomCell

Objective C

@interface RCCustomCell : RCFriendListPermanentCell
- (void)showPortrait:(NSString *)url;
@end

@implementation
// Cell 绘制
@end

2.自定义 RCCustomCellViewModel

提示

自定义 CellViewModel 需要继承 RCGroupInfoCellViewModel。

Objective C

@interface RCCustomCellViewModel: RCGroupInfoCellViewModel
@property (nonatomic, strong) RCGroupInfo *groupInfo;

/// 初始化
/// - Parameters:
///   - groupInfo: 群组信息
///   - keyword: 高亮关键字
- (instancetype)initWithGroupInfo:(RCGroupInfo *)groupInfo
                          keyword:(NSString *)keyword;
@end
@end

// 注册并自定义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
    ...
    return cell;
}

@end

3. 修改数据源

实现数据源回调代理方法：

Objective C

// 好友数据源
- (NSArray *_Nullable)searchGroupsViewModel:(RCSearchGroupsViewModel *_Nonnull)viewModel
                   willLoadItemsInDataSource:(NSArray *_Nullable)dataSource {
     // 对数据源增删改处理
        NSMutableArray *list = dataSource.mutableCopy;
        RCCustomCellViewModel *customCellVM = [[RCCustomCellViewModel alloc] initWithGroupInfo:"group" keyword:"关键字"];
        [list addObject:@[customCellVM]];
        return list;

}

4.自定义 cell 点击事件

Objective C

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