用途:这是 CometChat React UI Kit v6 组件名称、props 与用法的权威目录。在编写任何 <CometChat*> JSX 前先查此目录;未列出的组件即不存在于导出 API。组件从 @cometchat/chat-uikit-react 导入,SDK 类型从 @cometchat/chat-sdk-javascript 导入。官方文档:https://www.cometchat.com/docs/ui-kit/react/components-overview;Docs MCP:claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp。
适用:Vite + React、Next.js、React Router、Astro React islands 等 React 系集成,以及在搭建会话、消息、用户、群组、通话 UI 前。不适用:React Native、Angular、Android、iOS、Flutter、仅主题定制、纯 SDK 无 UI Kit 场景,应改用各自目录。
主要能力:核心消息组件为 CometChatConversations、CometChatMessageList、CometChatMessageComposer(含 CometChatCompactMessageComposer)、CometChatMessageHeader、CometChatUsers、CometChatGroups、CometChatSearch、CometChatThreadHeader、CometChatMessageInformation。注意 v6 已移除 CometChatConversationsWithMessages 等一体化组件,需自行组合两栏布局。
必要用法:列表项点击回调为 onItemClick;消息视图三件套每个只能传 user= 或 group= 之一;搜索必须使用 CometChatSearch,不要自建搜索栏;消息头 onItemClick 无默认行为,需自行接线详情面板,否则为死区;线程回复需绑定 onThreadRepliesClick,否则可 hideReplyInThreadOption={true};群聊私聊项可用 hideMessagePrivatelyOption={true} 移除。
限制:资料未提供安装命令与完整属性表,上述 props 依据所给目录;写入前请以已安装包或源码为准。SDK 类如 CometChat.User 既是值也是类型,使用 import { CometChat } 值导入最稳妥,import type 后不可再做 instanceof,否则运行时抛错。