会话列表页面介绍
大约 2 分钟
UIKit-iOS 集成文档
会话列表页面介绍
ConversationListController 用于展示当前用户的所有会话,包含单聊和群组聊天(不包括聊天室)。
页面功能
会话列表页面提供如下功能:
| 页面功能 | 描述 |
|---|---|
| 会话展示 | 展示所有单聊和群聊会话,按最新消息时间倒序排列。 |
| 会话状态展示 | 显示会话的未读消息数和免打扰状态。 |
| 会话搜索 | 点击搜索按钮,跳转至搜索页面进行会话查询。 |
| 进入聊天 | 点击会话条目,跳转至对应的聊天页面。 |
| 会话管理 | 支持会话置顶、删除、免打扰等操作。 |
| 扩展功能 | 点击标题栏的扩展按钮,可选择创建新会话、添加好友或创建群组。 |
页面组件
会话列表页面通过 ConversationListController 实现,由标题栏、搜索栏和会话列表组成。
会话列表页面 ConversationListController.swift

标题栏
会话列表页面与聊天页面、联系人列表页面、群详情页面、联系人详情页面的标题栏均使用 ChatNavigationBar。详见 设置标题栏。
会话搜索栏
会话搜索栏通过 UIButton 实现简单的点击触发,点击后跳转到 SearchConversationsController 进行搜索。关于自定义,详见 ConversationListController#createSearchBar 方法。
会话列表
会话列表组件 ConversationList 按最新消息时间倒序排列,置顶会话始终显示在顶部。列表包含以下类型的会话:
- 通过标题栏加号创建的本地会话。
- 发送消息后自动生成的单聊会话。
- 群组内发送消息后生成的群聊会话。
首次加载建议:在应用首次安装或卸载重装后,建议从服务端拉取历史会话列表,以填充本地数据库。
会话条目组件 ConversationCell 实现单条会话展示,每个会话条目展示以下信息:
| 元素 | 说明 |
|---|---|
| 头像 | 单聊显示对方头像(默认头像占位);群聊显示群组默认头像。 |
| 名称 | 单聊显示对方昵称或 ID;群聊显示群组名称或 ID。 |
| 最新消息 | 显示最近一条消息的内容。 |
| 消息时间 | 最新消息的发送时间。 |
| 状态标识 | 置顶、免打扰等状态图标。 |
交互操作:
- 点击:跳转至该会话的聊天页面。
- 长按:弹出操作菜单,支持免打扰、置顶、标记已读、删除。
关于会话自定义,详见 会话列表的基本设置 和 高级设置 说明。
创建会话列表页面
单群聊 UIKit 中提供 ConversationListController,支持作为根控制器、推入导航栈或以模态形式呈现,可根据需要灵活嵌入你的应用界面。
示例如下:
import UIKit
import EaseChatUIKit
let vc = EaseChatUIKit.ComponentsRegister.shared.ConversationsController.init()
ControllerStack.toDestination(vc: vc)
