---

url: 'https://wot-ui.cn/component/badge.md'

Badge 徽标

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

基础用法

展示新消息数量。

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

<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定义组件样式。

<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>

:deep(.badge) {
    margin: 0 30px 20px 0;
    display: inline-block;
}

最大值

可自定义最大值。

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

<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-dot为true时将始终显示红点。

<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>

自定义内容

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

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

<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。

<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 | 隐藏 badge | boolean | - | false | - |
| type | 类型 | string | primary / success / warning / danger / info | - | - |
| bg-color | 背景色 | string | 各种颜色的css写法 | - | - |
| show-zero | 是否显示0 | boolean | - | false | 0.1.62 |

外部样式类

| custom-class | 根节点样式 | - |