组件概述
ContactList 是基于 Jetpack Compose 构建的联系人列表组件,为用户提供完整的联系人管理功能。该组件支持好友列表展示、好友申请处理、群组列表管理、黑名单管理等功能,并提供了丰富的交互回调接口。
联系人列表 | 群组列表 | 好友申请列表 |
![]() | ![]() | ![]() |
组件集成
ContactList 组件属于 TUIKit Compose 的一部分,集成 TUIKit Compose 即可获取并使用 ContactList 组件。集成方法请参考文档 TUIKit Compose 里的集成步骤。组件构成
ContactList 是联系人列表里的主组件,对应着整个联系人列表页框架:方法名 | 参数 | 描述 |
ContactList | modifier: Modifier | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |
| onGroupClick: (ContactInfo) -> Unit | 点击群组的回调,可选参数。 |
| onContactClick: (ContactInfo) -> Unit | 点击联系人的回调,可选参数。 |
| contactListViewModelFactory: ContactListViewModelFactory | 创建组件内部 ContactListViewModel 的工厂类。通常情况下,您无需手动创建,组件已提供默认实现。 |
ContactList 上半部分预留了各个子视图的入口 cell,例如好友申请、群聊申请、群聊列表和黑名单列表。下半部分内嵌了联系人列表,如下图所示:
基础用法
在
ContactList 中点击好友申请、群聊申请、群聊列表和黑名单列表入口时,由组件自动完成路由,无需额外处理;点击群聊列表中的群组或联系人列表/黑名单中的个人时,会触发相应的回调接口 (onGroupClick/onContactClick),需监听回调并实现自定义跳转。路由跳转示例图如下所示:
初始化 ContactList 即可直接展示联系人列表,示例代码如下:
Box(modifier = Modifier.fillMaxSize().systemBarsPadding()) {ContactList(onGroupClick = {// 处理群组点击事件}, onContactClick = {// 处理联系人点击事件})}


