产品动态
公告
Android（Compose）
组件概述
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 = {// 处理联系人点击事件})}
文档反馈