Skip to content

Badge 徽标

徽标数组件,常用行为对齐 Ant Design Badgestatus 默认背景 class 由 packages/ui/src/theme/componentTokens.ts 中的 badgeStatusBgClass 维护。

示例

封顶与状态色

可访问性

Badge 的数字和圆点本身只是视觉提示,建议用 badgeLabel 为业务语境补充可访问名称,例如“5 条未读消息”或“在线”。当 dot 没有提供 badgeLabel 时,圆点会被标记为装饰性内容,避免辅助技术读出没有语义的空状态。

API

属性说明类型默认值
count展示内容;数字会参与 overflowCount 截断,字符串或自定义节点会直接渲染ReactNode0
dot显示小圆点booleanfalse
overflowCount超过后显示为 ${overflowCount}+number99
showZerocount 为 0 时是否展示booleanfalse
status状态色(作用于圆点或数字徽标背景)'default' | 'success' | 'processing' | 'error' | 'warning'-
offset相对默认位置的偏移 [x, y](px)[number, number]-
color自定义背景色string-
badgeLabel徽标可访问名称,用于说明数字或圆点的业务含义string-