Skip to content

徽章

徽章

徽章组件用于在元素右上角展示计数、小红点或状态标记,常用于消息提醒、新功能标记等场景。

基础用法

徽章可以直接附加在其他元素上,通过 value 属性设置显示的数值。

显示代码箭头
复制GitHub

小圆点

通过设置 isDot 属性,可以显示为一个小圆点,不显示具体数值。

显示代码箭头
复制GitHub

最大值

可以通过 max 属性设置最大显示数值,超过最大值时将显示为 "最大值+"。

显示代码箭头
复制GitHub

自定义颜色

通过 color 属性可以自定义徽章的背景颜色。

显示代码箭头
复制GitHub

位置偏移

可以通过 offsetXoffsetY 属性调整徽章的位置,实现灵活的位置定制。

显示代码箭头
复制GitHub

隐藏徽章

通过设置 hiddenValue 属性,当数值等于隐藏值时,徽章将不显示。

当前数值: 3
显示代码箭头
复制GitHub

徽章 API

属性

属性名说明类型可选值默认值
value显示的数值number
isDot是否显示为小圆点booleanfalse
max最大显示数值number99
color徽章背景颜色string#f56c6c
offsetXX轴偏移量number0
offsetYY轴偏移量number0
hiddenValue隐藏徽章时的值number0

插槽

插槽名说明
default徽章包裹的内容元素

样式变量

徽章组件使用了以下样式变量,可通过 SCSS 变量进行自定义:

变量名说明
$theme-color-danger主题色-危险
$color-white白色
$z-index-show显示层级
</rewritten_file>

基于MIT许可发布