未读/提及角标（UnreadBadge）

未读/提及角标：UnreadBadge 是 IDL 定义的跨端 UI 组件，props / events / behaviors 在各平台语义一致。本页给出契约属性、事件、渲染行为、数据源与 Web 端绑定/示例。

契约属性（props）​

属性类型必填说明
countint是未读数量（0 隐藏，>99 显示 99+）
mentionedCountint否@ 提及数量（独立角标）
mutedbool否是否被禁言（禁言时禁用发送并提示）

事件​

该组件未声明事件；交互通过属性和宿主回调完成。

渲染行为​

  • 0 隐藏；>99 显示 99+；muted 用灰点；提及用 @ 角标

数据源​

未在 IDL 声明 dataSource；由宿主从 IMLib 拉取（getConversationList / getHistoryMessages / MESSAGES / CONVERSATION 事件）。

依赖边界

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

平台绑定​

项值
公开符号 / 签名IMKit.mount(container, 'UnreadBadge', props)
导出列表包含是
UI 框架纯 DOM 组件（无框架依赖），CSS 变量主题，IMKit.mount(container, component, props)

使用示例​

JavaScript (ESM)
IMKit.mount(document.getElementById('badge'), 'UnreadBadge', {
  count: 128,
  mentionedCount: 2,
  muted: false,
});

相关文档​