Skip to content

Badge 徽章 ​

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

ts
import { createApp } from 'vue'
import { ElBadge } from '@szhn/dh-design-pc'

const app = createApp()
app.use(ElBadge)

基础用法 ​

可以用来展示新消息的数量。通过 type 指定语义色(primary / success / warning / danger / info),不要写死色值。

数量值可接受 Number 或 String。

形态 ​

单位数为正圆,多位数或文案为胶囊,小红点为 6px 圆点。

最大值 ​

你还可以自定义最大值

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

自定义显示内容 ​

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

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

小红点 ​

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

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

偏移量 ​

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

API ​

Attributes ​

属性名说明类型默认值
value显示值string / number''
max最大值,超过最大值会显示 {max}+。 只有当 value 是数字类型时起作用。number99
is-dot是否显示小圆点。booleanfalse
hidden是否隐藏 Badge。booleanfalse
typebadge 类型,控制徽章颜色。enum(primary / success / warning / danger / info)danger
show-zero值为零时是否显示 Badgebooleantrue
color背景色string
offsetbadge 的偏移量array[0, 0]
badge-style自定义 badge 样式object—
badge-class自定义 badge 类名string—

Slots ​

插槽名说明类型
default自定义默认内容-
content自定义显示内容object