Skip to content

角标 Badge ​

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

基础用法 ​

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

8
隐藏源代码

最大值 ​

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

5
99+
隐藏源代码

点模式 ​

通过设置 dot 为 true 只显示小圆点。

隐藏源代码

主题 ​

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
隐藏源代码

内容插槽 ​

当 dot 为 false 时,可使用 content 插槽自定义角标内容。

HOT
* HOT
隐藏源代码

API ​

BadgeProps ​

属性类型可选默认值描述版本
valuenumber | string是''角标显示的数值或字符串。0.1.0
maxnumber是数值上限,超出显示为 ${max}+。0.1.0
dotboolean是false是否以小圆点显示。0.1.0
theme'primary' | 'sakura' | 'success' | 'warning' | 'danger' | 'notice'是'danger'角标的主题。0.1.0
visibleboolean是true是否可见。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
pollSizeChangeboolean是false开启轮询组件尺寸变化,可能会影响性能。0.1.0

BadgeSlots ​

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