我的群组页面

提示

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

我的群组页面展示了当前用户已加入的群组。进入该页面，IMKit SDK 就会从数据库中拉取群组信息。 IMKit 提供基于 UITableView 的群组页面类 RCMyGroupsViewController。

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

初始化

调用 RCMyGroupsViewController 类的初始化方法构建列表页面。 注意，您需要创建一个 RCMyGroupsViewModel 对象， 作为RCMyGroupsViewController 的业务逻辑处理模块。

参数说明

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

示例代码

Objective C

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

定制化

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

自定义标题栏

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

Objective C

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

自定义搜索框

RCMyGroupsViewController 搜索框默认是实现跳转到搜索群组页面，您可以通过设置 RCMyGroupsViewModel 的 delegate 属性，实现自定义搜索代理方法来自定义搜索功能。

示例代码

Objective C

RCMyGroupsViewModel *viewModel = [[RCMyGroupsViewModel alloc] init];
viewModel.delegate = self;
RCMyGroupsViewController *vc = [[RCMyGroupsViewController alloc] initWithViewModel:viewModel];

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

...

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

自定义我的群组页面 Cell

1. 自定义 RCCustomCell

Objective C

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

@implementation
// Cell 绘制
@end

2.自定义 RCCustomCellViewModel

提示

自定义 CellViewModel 需要继承 RCGroupInfoCellViewModel。

Objective C

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

/// 初始化
///   - keyword: 高亮关键字
- (instancetype)initWithGroupInfo:(RCGroupInfo *)groupInfo
                          keyword:(NSString *)keyword;

@end

@implementation RCCustomCellViewModel

- (instancetype)initWithGroupInfo:(RCGroupInfo *)groupInfo
                          keyword:(NSString *)keyword
{
    self = [super init];
    if (self) {
        self.groupInfo = groupInfo;
        self.keyword = keyword;
    }
    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.groupInfo.groupName;
...
    return cell;
}
@end

3. 修改数据源

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

Objective C

// 数据源
- (NSArray *_Nullable)myGroupsViewModel:(RCMyGroupsViewModel *)viewModel
              willLoadItemsInDataSource:(NSArray *_Nullable)dataSource{
     // 对数据源增删改处理

}

4.自定义 cell 点击事件

Objective C

/// 配置自定义点击事件,Returns: App 是否处理[YES : SDK 不再处理, NO: SDK 内部处理]
- (BOOL)myGroupsViewModel:(RCMyGroupsViewModel *)viewModel
           viewController:(UIViewController*)viewController
                tableView:(UITableView *)tableView
             didSelectRow:(NSIndexPath *)indexPath
            cellViewModel:(RCBaseCellViewModel *)cellViewModel {

              }