组件概述
ContactList 是联系人列表组件,为用户提供完整的联系人管理功能。该组件支持好友列表展示、好友申请处理、群组列表管理、黑名单管理等功能,并提供了丰富的交互回调接口。
联系人列表 | 群组列表 | 好友申请列表 |
![]() | ![]() | ![]() |
组件集成
ContactList 组件属于 TUIKit Flutter 的一部分,集成 TUIKit Flutter 即可获取并使用 ContactList 组件。集成方法请参考文档 TUIKit Flutter 里的集成步骤。组件构成
ContactList 是联系人列表里的主组件,对应着整个联系人列表页框架:方法名 | 参数 | 描述 |
ContactList | onGroupClick: (ContactInfo) {} | 点击群组的回调,可选参数。 |
| onContactClick: (ContactInfo) {} | 点击联系人的回调,可选参数。 |
ContactList 上半部分预留了各个子视图的入口 cell,例如好友申请、群聊申请、群聊列表和黑名单列表。下半部分内嵌了联系人列表,如下图所示:
基础用法
在
ContactList 中点击好友申请、群聊申请、群聊列表和黑名单列表入口时,由组件自动完成路由,无需额外处理;点击群聊列表中的群组或联系人列表/黑名单中的个人时,会触发相应的回调接口 (
onGroupClick/onContactClick),需监听回调并实现自定义跳转。路由跳转示例图如下所示:

初始化 ContactList 即可直接展示联系人列表,示例代码如下:
ContactList(onGroupClick: (ContactInfo contactInfo) {// 处理群组点击事件},onContactClick: (ContactInfo contactInfo) {// 处理联系人点击事件},),


