Skip to content

Badge 徽标

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

引入

js

html
<script type="module">
  import "./node_modules/easy-component-ui/components/ea-badge/index.js";
</script>

css

TIP

需要注意的是, 如果需要使用到带有图标的 属性/组件, 需要提前使用 link 标签引入图标文件

html
<link
  rel="stylesheet"
  href="./node_modules/easy-component-ui/components/ea-icon/index.css"
/>

自定义样式

移步到 CSS Part

基础用法

通过设置 value 属性展示新消息数量。

评论回复成功警告信息
查看代码
html
<div class="row left">
  <ea-badge value="12">
    <ea-button size="small">评论</ea-button>
  </ea-badge>
  <ea-badge value="3" type="primary">
    <ea-button size="small">回复</ea-button>
  </ea-badge>
  <ea-badge value="12" type="success">
    <ea-button size="small">成功</ea-button>
  </ea-badge>
  <ea-badge value="3" type="warning">
    <ea-button size="small">警告</ea-button>
  </ea-badge>
  <ea-badge value="3" type="info">
    <ea-button size="small">信息</ea-button>
  </ea-badge>
</div>

最大值

可通过设置 max 属性自定义最大值。

TIP

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

评论回复
查看代码
html
<div class="row left">
  <ea-badge value="11" max="10">
    <ea-button size="small">评论</ea-button>
  </ea-badge>
  <ea-badge value="100" max="99">
    <ea-button size="small">回复</ea-button>
  </ea-badge>
</div>

自定义内容

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

TIP

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

评论回复
显示代码
html
<div class="row left">
  <ea-badge value="new">
    <ea-button size="small">评论</ea-button>
  </ea-badge>
  <ea-badge value="hot">
    <ea-button size="small">回复</ea-button>
  </ea-badge>
</div>

小红点

可以设置is-dot属性, 使徽标以红点的形式标注需要关注的内容

评论信息
点击查看代码
html
<div class="row left">
  <ea-badge is-dot>
    <ea-button size="small">评论</ea-button>
  </ea-badge>
  <ea-badge is-dot>信息</ea-badge>
  <ea-badge is-dot>
    <ea-button size="small" icon="icon-mail"></ea-button>
  </ea-badge>
</div>

Attributes

参数说明类型可选值默认值
value显示值String / Number
max最大值,超过最大值会显示 {max}+,仅当 valueNumber 时生效Number
is-dot是否显示小圆点Booleanfalse
type徽标颜色Stringprimary / success / warning / danger / infoprimary

CSS Part

用法可参考 MDN ::part()伪类

名称说明
containerbadge 外层容器
contentvalue 属性所在的容器