用途:CometChat Flutter UIKit v5 的 CometChatConversations 组件用于展示最近会话列表,适用于聊天应用中的会话入口页。
主要能力:可通过 conversationsRequestBuilder 自定义拉取条件(如 limit、conversationType);通过 conversationsStyle 设置视觉样式;支持 onItemTap、onItemLongPress 回调;提供 subtitleView、listItemView、leadingView、titleView、trailingView 等自定义插槽;可设置 title、showBackButton、onBack、hideAppbar、appBarOptions;控制 usersStatusVisibility、receiptsVisibility、textFormatters、controllerTag、hideSearch、searchReadOnly、onSearchTap、deleteConversationOptionVisibility;支持 loadingStateView、emptyStateView、errorStateView 自定义状态视图;setOptions 与 addOptions 可替换或追加长按选项。
使用方式:直接实例化组件并传入回调,例如在 onItemTap 中判断 conversation.conversationWith 是 User 还是 Group,再导航到消息页。自定义请求可传入 ConversationsRequestBuilder 并设置 limit、conversationType。组件内部通过 GetX 在 initState 中 Get.put 创建 CometChatConversationsController,并在 dispose 中删除(除非外部提供 controllerTag)。主题值在 didChangeDependencies 中缓存。
限制与注意:不要在组件挂载前用 Get.find 获取控制器,也不要手动在组件外创建控制器;onItemTap 中需从 conversation.conversationWith 提取 User/Group 并做类型检查,否则会类型错误。trailingView 为单参数,与其他插槽不对称。资料未提供收费、价格、平台或效果信息。