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 是数字类型时起作用。 | number | 99 |
| is-dot | 是否显示小圆点。 | boolean | false |
| hidden | 是否隐藏 Badge。 | boolean | false |
| type | badge 类型,控制徽章颜色。 | enum(primary / success / warning / danger / info) | danger |
| show-zero | 值为零时是否显示 Badge | boolean | true |
| color | 背景色 | string | |
| offset | badge 的偏移量 | array | [0, 0] |
| badge-style | 自定义 badge 样式 | object | — |
| badge-class | 自定义 badge 类名 | string | — |
Slots
| 插槽名 | 说明 | 类型 |
|---|---|---|
| default | 自定义默认内容 | - |
| content | 自定义显示内容 | object |
