会话列表（ConversationListView）

会话列表：ConversationListView 是 IDL 定义的跨端 UI 组件，props / events / behaviors 在各平台语义一致。本页给出契约属性、事件、渲染行为、数据源与 Native (C ABI) 端绑定/示例。

契约属性（props）​

属性类型必填说明
conversationsConversation[]是会话数组（来自 IMLib.getConversationList / CONVERSATION 事件）
activeTargetIdstring否当前高亮会话的 targetId
themeTheme否主题对象（mode + 9 个颜色令牌）
options{showPinned:bool,showUnread:bool,showDraft:bool,showMention:bool}否显示选项（置顶 / 未读 / 草稿 / @ 提及）：{ showPinned:bool, showUnread:bool, showDraft:bool, showMention:bool }

事件​

事件参数说明
selectconversation点击会话，宿主负责跳转到 ChatView
longpressconversation长按会话，宿主展示操作菜单（置顶 / 免打扰 / 删除）
refresh—下拉刷新，宿主重新拉取会话列表

渲染行为​

  • 排序：置顶优先，其余按 updatedAt 倒序
  • 未读角标：unreadCount>0 显示；>99 显示 99+；mention count 独立角标
  • 免打扰（notificationLevel=2）显示静音图标且不显示红点（保留数字可选）
  • 空闲（无会话）显示空态；加载中显示骨架
  • 点击会话触发 select，宿主负责跳转 ChatView

数据源​

IMLib.getConversationList / CONVERSATION 事件增量更新

依赖边界

组件不直连网络与数据库：会话/消息由宿主从 IMLib 拉取后传入，组件只做排序、角标、格式化与渲染。

平台绑定​

项值
公开符号 / 签名im_kit_conversation_model_new(im_client_t*) / im_kit_conversation_model_refresh(model, char** out_json)
导出列表包含—
UI 框架view-model / 格式化 / 角标 / 状态计算层（不访问网络，不渲染 UI）

使用示例​

C（view-model 层）
im_kit_conversation_model_t* list = im_kit_conversation_model_new(client);
im_kit_conversation_model_set_json(list, conversations_json);
im_kit_conversation_model_set_options(
    list, "{\"showPinned\":true,\"showUnread\":true,\"showDraft\":true,\"showMention\":true}");

char* view_json = NULL;
if (im_kit_conversation_model_refresh(list, &view_json) == 0) {
    /* 渲染 view_json：排序、角标、草稿预览、空态 */
}
im_kit_string_free(view_json);
im_kit_conversation_model_free(list);

相关文档​