Flutter

最近更新时间:2025-11-25 16:27:12

我的收藏

组件概述

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