Skip to content

Badge 徽章 ​

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

TIP

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

基本用法 ​

可以用来展示新消息的数量, 数量值可接受 Number 或 String。

最大值​ ​

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

自定义显示内容​ ​

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

点状徽章 ​

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

自定义颜色 ​

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

零值徽章 ​

当 showZero 为 true 时,徽章会显示为一个点。

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';