Skip to content

角标 Badge

一个用于显示计数、状态或提醒的小角标,附加到其他元素上(如按钮或图标)。

基础用法

将 Badge 附加到其他元素上以显示小角标。

8
隐藏源代码

最大值

max 设置角标的最大值,超过时以 ${max}+ 展示。

5
99+
隐藏源代码

点模式

通过设置 dottrue 只显示小圆点。

隐藏源代码

主题

Badge 支持主题:'primary''sakura''success''warning''danger''notice'

1
1
4
5
1
4
隐藏源代码

角标偏移

通过 offset 调整角标位置。支持数字、数组 [x: number, y: number] 或对象 { x: number, y: number }

?
!
隐藏源代码

自定义颜色

通过 color 设置角标背景色;通过 borderColor 设置角标边框颜色。

99
隐藏源代码

显示和隐藏

通过 visible 属性控制角标显示与否。

5
隐藏源代码

内容插槽

dotfalse 时,可使用 content 插槽自定义角标内容。

HOT
* HOT
隐藏源代码

API

BadgeProps

属性类型可选默认值描述版本
valuenumber | string''角标显示的数值或字符串。0.1.0
maxnumber数值上限,超出显示为 ${max}+0.1.0
dotbooleanfalse是否以小圆点显示。0.1.0
theme'primary' | 'sakura' | 'success' | 'warning' | 'danger' | 'notice''danger'角标的主题。0.1.0
visiblebooleantrue是否可见。0.1.0
offsetnumber | [number, number] | { x?: number; y?: number }0角标标记的偏移。0.1.0
colorstring自定义背景色,详见 支持的颜色解析0.1.0
borderColorstring自定义边框颜色。0.1.0
contentPropsRestAttrs透传给角标内容容器 DOM 的额外属性。0.1.0
pollSizeChangebooleanfalse开启轮询组件尺寸变化,可能会影响性能。0.1.0

BadgeSlots

插槽参数描述版本
default包裹的附着元素插槽。0.1.0
contentvalue: string | string角标内容插槽(在 dotfalse 时生效)。0.1.0