会话列表页面介绍

ConversationList 用于展示当前用户的所有会话，包含单聊和群组聊天（不包括聊天室）。

页面功能

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

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

页面组件

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

会话列表页面 ConversationList

标题栏

标题栏使用统一的 TopNavigationBar 组件，与聊天页面、联系人列表、群详情和联系人详情等页面保持一致。详见 设置标题栏。

会话搜索栏

会话搜索栏 SearchConversation 实现会话搜索。点击搜索按钮，跳转到搜索页面，支持按会话名称过滤。关于自定义，详见 设置会话搜索栏。

会话列表

会话列表组件 ConversationList 按最新消息时间倒序排列，置顶会话始终显示在顶部。列表包含以下类型的会话：

• 通过标题栏加号创建的本地会话。
• 发送消息后自动生成的单聊会话。
• 群组内发送消息后生成的群聊会话。

首次加载建议：在应用首次安装或卸载重装后，建议从服务端拉取历史会话列表，以填充本地数据库。

会话条目组件 ConversationListItem 实现单条会话展示，每个会话条目展示以下信息：

元素	说明
头像	单聊显示对方头像（默认头像占位）；群聊显示群组默认头像。
名称	单聊显示对方昵称或 ID；群聊显示群组名称或 ID。
最新消息	显示最近一条消息的内容。
消息时间	最新消息的发送时间。
状态标识	置顶、免打扰等状态图标。

交互操作：

• 点击：跳转至该会话的聊天页面。
• 长按：弹出操作菜单，支持免打扰、置顶、标记已读、删除。

关于会话自定义，详见 会话列表的基本设置 和 高级设置 说明。

创建会话列表页面

单群聊 UIKit 提供 ConversationList，添加到 Activity 中即可使用。

import type { NativeStackScreenProps } from '@react-navigation/native-stack';

type Props = NativeStackScreenProps<RootScreenParamsList>;
export function ConversationListScreen(props: Props) {
  const navi = useNativeStackRoute();
  return (
    <ConversationList
      onClickedNewGroup={() => {
        navi.push({ to: 'CreateGroup' });
      }}
      onClickedNewConversation={() => {
        navi.navigate({ to: 'NewConversation' });
      }}
    />
  );
}