element/examples/docs/badge.md
2016-08-18 17:29:11 +08:00

4.1 KiB
Raw Blame History

基础用法

Badge 组件可以在右上角展示标记,最常见的用法是用于展示消息数,定义value属性,它接受Number或者String

下面是一个样例,我们在 Badge 组件内嵌入 Button 组件:

评论 回复 评论 回复
<el-badge :value="12" class="item">
  <el-button size="small">评论</el-button>
</el-badge>
<el-badge :value="3" class="item">
  <el-button size="small">回复</el-button>
</el-badge>

<el-dropdown text="点我查看" type="text" :icon-separate="false" trigger="click">
  <el-dropdown-item class="clearfix">
    评论
    <el-badge class="mark" :value="12" />
  </el-dropdown-item>
  <el-dropdown-item class="clearfix">
    回复
    <el-badge class="mark" :value="3" />
  </el-dropdown-item>
</el-dropdown>

最大值

为了方便使用Badge 组件可以自定义显示的最大值,由max属性定义,它接受一个Number,需要注意的是,只有当valueNumber时,它才会生效。

下面是一个样例:

评论 回复
<el-badge :value="200" :max="99" class="item">
  <el-button size="small">评论</el-button>
</el-badge>
<el-badge :value="100" :max="10" class="item">
  <el-button size="small">回复</el-button>
</el-badge>

自定义内容

定义valueString类型是时可以用于显示自定义文本,下面是两个样例,它们可以启发你在适时的情况使用 Badge

评论 回复
<el-badge value="new" class="item">
  <el-button size="small">评论</el-button>
</el-badge>
<el-badge value="hot" class="item">
  <el-button size="small">回复</el-button>
</el-badge>

小红点

除了数字外,设置is-dot属性,它接受一个Boolean。可以使badge组件显示为一个小红点来提醒用户需要关注的内容此时设置其他属性均无效。

数据查询
<el-badge is-dot class="item">数据查询</el-badge>
<el-badge is-dot class="item">
  <el-button class="share-button" icon="share" type="primary"></el-button>
</el-badge>

Attributes

参数 说明 类型 可选值 默认值
value 显示值 string, number
max 最大值,超过最大值会显示 '{max}+',要求 value 是 Number 类型 number
is-dot 小圆点 boolean false