SuperAPI AI 工具集

cometchat-flutter-v6-customization

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

该技能文档介绍 CometChat Flutter UIKit v6 的四级自定义模型,从最轻量到最深入逐层展开。

用途:在默认 UI 之外定制会话、用户、群组、消息列表与输入框等组件。建议从第一级开始,仅在较轻层级无法解决问题时才深入。

主要能力:

  1. 属性与视图插槽:列表类组件提供回调,可替换整条列表项或局部插槽,如 titleView、subtitleView、leadingView、trailingView 及空、错、加载状态视图。
  2. 请求构建器:通过 ConversationsRequestBuilder、MessagesRequestBuilder、UsersRequestBuilder、GroupsRequestBuilder、GroupMembersRequestBuilder 控制拉取数据的过滤与分页,如 limit、tags、searchKeyword、roles、scopes 等。
  3. 文本格式化器与消息模板:CometChatTextFormatter 可自定义消息列表与输入框中的文本样式;内置 Mentions、Markdown、URL、电话号码、邮箱格式化器。CometChatMessageTemplate 控制消息气泡渲染与长按菜单选项,可用 templates 替换全部或用 addTemplate 追加自定义类型。
  4. BubbleFactory 与 DataSource:BubbleFactory 按 category_type 键渲染消息内容,DefaultBubbleFactories 默认注册 message_text、message_image、message_video、message_audio、message_file 与 deleted;可通过 addTemplate 注册自定义工厂。DataSource 层采用 Clean Architecture,可按组件传入自定义 BLoC 定制数据获取。

样式覆盖:每个组件有对应 Style 类,继承 ThemeExtension,采用 merge() 与 copyWith() 叠加主题默认值;父组件可在 didChangeDependencies() 中缓存主题,避免键盘动画时重复查询。

限制:资料未提供安装命令、版本要求、收费与价格信息,暂未提供相关平台与效果说明。