Skip to content

Badge 徽标

介绍

展示徽标数字或小红点。

基础用法

通过 color 属性来设置徽标颜色,通过 dot 属性来设置是否展示为小红点。

html
<!-- 文字展示 -->
<vd-badge :color="`#1989fa`" value="1" />
<!-- 展示为小红点-->
<vd-badge :color="`#1989fa`" :dot="true" />

设置最大值

通过 max 属性来设置最大值,超过最大值会显示 max+

html
<vd-badge :color="`#1989fa`" value="999" :max="9" />

徽标位置

通过 position 属性来设置徽标位置,可选值为 static top-left top-right bottom-left bottom-right

html
<!-- 上左 -->
<vd-badge :color="`#1989fa`" value="1" position="top-left" />
<!-- 上右 -->
<vd-badge :color="`#07c160`" value="2" position="top-right" />
<!-- 下左 -->
<vd-badge :color="`#ff976a`" value="3" position="bottom-left" />
<!-- 下右 -->
<vd-badge :color="`#ee0a24`" value="4" position="bottom-right" />

自定义徽章内容

通过插槽来自定义徽章内容。

html
<vd-badge :color="`#1989fa`" position="top-right">
  <vd-icon name="star" />
</vd-badge>

API

Props

参数说明类型默认值
color颜色string-
value内容string | number-
dot是否展示为小红点booleanfalse
max最大值,超过最大值会显示 max+string | number-22
position徽标位置BadgePosition'static'
show-zero当 value 为 0'0' 时,是否展示徽标booleanfalse

代替原始 Props

参数说明类型默认值
custom-id根节点idstring-
custom-class根节点类名ClassValue-
custom-style根节点样式StyleValue-

Events

事件名说明回调参数
click点击时触发MouseEvent

Slots

名称说明
default自定义内容

赣ICP备2025061025号-1