Skip to content

Badge 徽标

出现在按钮、图标旁的数字或状态标记。

基础用法

展示新消息数量。

定义modelValue属性,它接受Number或者String

html
<wd-badge modelValue="12">
  <wd-button size="small">评论</wd-button>
</wd-badge>

<wd-badge modelValue="12px">
  <wd-button size="small">评论</wd-button>
</wd-badge>

修改背景色

设置 type 属性,也可以自定义背景色 bg-color,也可以通过custom-class定义组件样式。

html
<wd-badge custom-class="badge" modelValue="3" bg-color="pink">
  <wd-button size="small">回复</wd-button>
</wd-badge>
<wd-badge custom-class="badge" modelValue="1" type="primary">
  <wd-button size="small">评论</wd-button>
</wd-badge>
<wd-badge custom-class="badge" modelValue="2" type="warning">
  <wd-button size="small">回复</wd-button>
</wd-badge>
<wd-badge custom-class="badge" modelValue="1" type="success">
  <wd-button size="small">评论</wd-button>
</wd-badge>
<wd-badge custom-class="badge" modelValue="2" type="info">
  <wd-button size="small">回复</wd-button>
</wd-badge>
scss
:deep(.badge) {
    margin: 0 30px 20px 0;
    display: inline-block;
}

最大值

可自定义最大值。

max属性定义,它接受一个Number,需要注意的是,只有当modelValueNumber时,它才会生效。

html
<wd-badge modelValue="200" max="99">
  <wd-button size="small">评论</wd-button>
</wd-badge>
<wd-badge modelValue="100" max="10">
  <wd-button size="small">回复</wd-button>
</wd-badge>

展示 0 值

可使用show-zero属性,自定义是否展示 0 值。需要注意的是,is-dot 属性优先级高于 show-zero 属性,is-dottrue时将始终显示红点。

html
<wd-badge modelValue="0" max="99" show-zero>
  <wd-button size="small">评论</wd-button>
</wd-badge>
<wd-badge modelValue="0" max="10">
  <wd-button size="small">回复</wd-button>
</wd-badge>

自定义内容

可以显示数字以外的文本内容。

定义modelValueString类型是时可以用于显示自定义文本。

html
<wd-badge modelValue="new">
  <wd-button size="small">评论</wd-button>
</wd-badge>
<wd-badge modelValue="hot">
  <wd-button size="small">回复</wd-button>
</wd-badge>

点状标注

以红点的形式标注需要关注的内容。

除了数字外,设置is-dot属性,它接受一个Boolean

html
<wd-badge is-dot>数据查询</wd-badge>
<wd-badge is-dot>
  <wd-button class="share-button" ></wd-button>
</wd-badge>

Attributes

参数说明类型可选值默认值最低版本
v-model显示值string / number---
max最大值,超过最大值会显示 '{max}+',要求 value 是 Number 类型number---
top为正时,角标向下偏移对应的像素number---
right为正时,角标向左偏移对应的像素number---
is-dot红色点状标注boolean-false-
hidden隐藏 badgeboolean-false-
type类型stringprimary / success / warning / danger / info--
bg-color背景色string各种颜色的css写法--
show-zero是否显示0boolean-false0.1.62

外部样式类

类名说明最低版本
custom-class根节点样式-

Released under the MIT License.

Released under the MIT License.