HarmonyOS

最近更新时间:2025-11-25 09:48:01

我的收藏

组件概述

MessageInput 是基于 ArkUI 构建的消息输入组件,为用户提供完整的消息编辑和发送功能。该组件支持多种消息类型的输入和发送,包括文本消息、图片、视频、文件、语音等,同时提供表情选择等增强功能,支持多种样式配置和自定义选项。
消息输入界面
表情选择器



组件集成

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

组件构成

MessageInput 组件包含消息输入核心组件和样式配置协议,提供了消息输入功能,并支持自定义。

初始化参数

参数名
类型
描述
conversationID
string
会话 ID,用于标识当前聊天会话。
如果是单聊,组成方式为 c2c_userID。
如果是群聊,组成方式为 group_groupID。
config
MessageInputConfigProtocol
输入样式配置,控制各功能按钮的显示

公开接口

方法名
参数
描述
MessageInput
conversationID: string, config: MessageInputConfigProtocol
初始化消息输入组件

基础用法

MessageInput 组件可直接初始化使用,需要提供会话 ID。

import { MessageInput, ChatMessageInputConfig } from '@tencentcloud/atomicx'

MessageInput({
conversationID: 'c2c_user123',
})

自定义组件

您可以自定义决定是否显示输入栏上的功能入口:
// 自定义显示哪些功能按钮
MessageInput({
conversationID: 'c2c_user123',
config: new ChatMessageInputConfig({
isShowAudioRecorder: false, // 隐藏语音录制
isShowPhotoTaker: true, // 显示拍照功能
isShowMore: true, // 显示更多功能
isShowSendButton: true, // 显示发送按钮
}),
})

自定义效果如下图所示:
默认输入框
隐藏输入框上的语音录制功能
隐藏输入框上的全部功能