会话列表页面介绍

大约 2 分钟

会话列表页面介绍

ConversationListController 用于展示当前用户的所有会话,包含单聊和群组聊天(不包括聊天室)。

页面功能

会话列表页面提供如下功能:

页面功能描述
会话展示展示所有单聊和群聊会话,按最新消息时间倒序排列。
会话状态展示显示会话的未读消息数和免打扰状态。
会话搜索点击搜索按钮,跳转至搜索页面进行会话查询。
进入聊天点击会话条目,跳转至对应的聊天页面。
会话管理支持会话置顶、删除、免打扰等操作。
扩展功能点击标题栏的扩展按钮,可选择创建新会话、添加好友或创建群组。

页面组件

会话列表页面通过 ConversationListController 实现,由标题栏、搜索栏和会话列表组成。

标题栏

会话列表页面与聊天页面、联系人列表页面、群详情页面、联系人详情页面的标题栏均使用 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)
上次编辑于: