Badge 徽章

按钮和图标上的数字或状态标记。

基础用法

可以用来展示新消息的数量。

数量值可接受 Number 或 String。

12
3
1
2
1

最大值

你还可以自定义最大值

由 max 属性定义,接受 Number 值。请注意,仅在值也是 Number 时起作用。

99+
10+

自定义显示内容

你也可以展示除数字以外你想要展示的任何值。或者您可以使用 content 栏位自定义内容。

当 value 是 String 时,可以显示自定义文字。或者使用 content 插槽。

new
hot
99

小红点

通过一个小红点标记来告知用户有新内容。

使用 is-dot 属性。是个布尔值。

query

偏移量 2.7.0

设置徽章点的偏移,格式是[左,顶部], 代表状态点从左侧和默认位置顶部的偏移。

1

Badge API

Badge Attributes

属性名说明类型默认值
value显示值string / number—
max最大值,超出显示 {max}+ 形式,仅 value 为数字时生效number99
is-dot是否显示为小圆点booleanfalse
hidden是否隐藏徽章booleanfalse
type徽章类型enumdanger
show-zerovalue 为 0 时是否显示booleantrue
color自定义圆点背景色string—
badge-style徽章样式object—
badge-class徽章类名string—
offset徽章偏移量 [x, y]array[0, 0]

Badge Slots

插槽名说明React 写法
default徽章包裹的内容children
content自定义徽章内容,参数为计算后的值content