Skip to content

Badge 徽章

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

TIP

Badge 组件对应 GvBadge,下方示例可直接交互,点击「显示代码」查看源码。

基本用法

可以用来展示新消息的数量, 数量值可接受 NumberString

最大值​

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

自定义显示内容​

可以展示除数字以外想要展示的任何值。 当 valueString 时,可以显示自定义文字。

点状徽章

通过一个小红点标记来告知用户有新内容。使用 is-dot 属性。 是个布尔值。

自定义颜色

通过 color 属性自定义徽章的颜色。

零值徽章

showZerotrue 时,徽章会显示为一个点。

API

Attributes

属性名说明类型默认值
value设置标记数量number / string''
max最大值,超过最大值会显示 {max}+。 只有当 value 是数字类型时起作用。number10
isDot是否为点状徽章booleanfalse
hidden是否隐藏徽章booleanfalse
type设置徽章类型stringwarning
showZero是否显示零值徽章booleanfalse
color自定义徽章颜色string

Events

类型定义

typescript
// Badge 类型
type BadgeType = 'primary' | 'success' | 'warning' | 'danger' | 'info';