未读/提及角标(UnreadBadge)

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

契约属性(props)​

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

事件​

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

渲染行为​

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

数据源​

未在 IDL 声明 dataSource;由宿主从 IMLib 拉取(getConversationList / getHistoryMessages / MESSAGES / CONVERSATION 事件)。

依赖边界

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

平台绑定​

项值
公开符号 / 签名io.nipaas.imkit.widget.UnreadBadgeView — setUnreadCount(count: Int) / setMentionedCount(count: Int) / setMuted(muted: Boolean) / UnreadBadgeFormatter.format(unreadCount: Int, mentionedCount: Int): String
导出列表包含—
UI 框架View 体系:Fragment + RecyclerView + XML;Provider 注册表驱动消息气泡渲染

使用示例​

Kotlin
UnreadBadgeView(context).apply {
    setUnreadCount(128)
    setMentionedCount(2)
    setMuted(false)
}

相关文档​