HarmonyOS

最近更新时间:2025-11-17 11:28:42

我的收藏

组件概述

ChatSetting 是基于 ArkUI 构建的聊天设置组件集合,主要包含单聊设置(C2CChatSetting)和群聊设置(GroupChatSetting)两个核心组件。这些组件为用户提供了完整的聊天会话管理功能,包括用户信息管理、权限设置、群组管理等核心能力。
单聊设置界面
群聊设置界面
















组件集成

ChatSetting 组件属于 TUIKit ArkUI 的一部分,集成 TUIKit ArkUI 即可获取并使用 ChatSetting 组件。集成方法请参考文档 TUIKit ArkUI 里的集成步骤。

组件构成

ChatSetting 包含两个主要组件:C2CChatSetting(单聊设置)和 GroupChatSetting(群聊设置),每个组件都提供了丰富的配置选项。

单聊设置(C2CChatSetting)

对外方法

方法名
参数名
类型
描述
C2CChatSetting
userID
string
对方用户 ID,用于标识聊天对象。
onSendMessageClick?
() => void
发送消息按钮点击回调,可选参数。
onContactDelete?
() => void
删除联系人按钮点击回调,可选参数。

群聊设置(GroupChatSetting)

对外方法

方法名
参数名
类型
描述
GroupChatSetting
groupID
string
群组 ID,用于标识群聊。
onSendMessageClick
() => void
发送消息按钮点击回调,可选参数。
onGroupDelete
() => void
解散/退出群组点击回调,可选参数。

基础用法

初始化 C2CChatSetting 即可直接展示单聊设置页面,示例代码如下:
Row {
C2CChatSetting({
userID: this.userID,
onSendMessageClick: (newConversationID?: string, title?: string, avatarUrl?: string) => {
// 处理发送消息点击事件
},
onContactDelete: () => {
// 处理删除联系人点击事件
}
}
}
初始化 GroupChatSetting 即可直接展示群聊设置页面,示例代码如下:
Row() {
GroupChatSetting({
groupID: this.groupID,
onSendMessageClick: (newConversationID?: string, title?: string, avatarUrl?: string) => {
// 处理发送消息点击事件
},
onGroupDelete: () => {
// 处理发送群组解散、离开群聊点击事件
},
})
}