Android(Compose)

最近更新时间:2025-11-17 11:28:42

我的收藏

组件概述

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 = {
// 处理联系人点击事件
})
}