跳到正文

Badge 徽标 ​

图标或文字右上角的数字/圆点徽标,用于未读数、消息提醒等场景。

使用方式 ​

组件以 EmBadge 为名导出,全局注册后可直接使用:

vue
<template>
  <em-badge :count="5">
    <em-avatar name="A" />
  </em-badge>
</template>

数字徽标 ​

自定义颜色 ​

API ​

Badge API ​

Props ​

属性类型默认值说明
countnumber—徽标数字;超过 max 显示为 "max+";为 0 或未传时不显示(dot 模式除外)
maxnumber99数字显示上限,超出后显示为 "max+",默认 99
dotbooleanfalse红点模式:仅显示小圆点不显示数字,默认 false
colorstring'var(--uikit-badge-bg, #FF7070)'徽标颜色(默认 --uikit-badge-bg #FF7070):filled 作背景色,stroked 作文字与描边色
sizeBadgeSize'l'尺寸:xs(仅圆点)/ s / m / l(默认)/ xl / xxl
variantBadgeVariant'filled'风格:filled(实心,默认)/ stroked(描边)
placementBadgePlacement'top-right'徽标相对容器的位置:top-right(默认)/ bottom-right
borderedbooleanfalse是否给徽标加 2px 描边与底层内容(如头像)分界;颜色跟随 --uikit-bg-base,暗色自适应
inlinebooleanfalse内联模式:徽标不占位覆盖,按文档流渲染(如会话列表行尾未读数),默认 false;开启后 placement 不生效