Badge 徽标数

概述

主要用于通知未读数的角标,提醒用户点击。

代码示例

Badge 徽标数 - 图1

基础用法

最简单的使用方法。

  1. <style scoped>
  2. .demo-badge{
  3. width: 42px;
  4. height: 42px;
  5. background: #eee;
  6. border-radius: 6px;
  7. display: inline-block;
  8. }
  9. </style>
  10. <template>
  11. <Badge :count="3">
  12. <a href="#" class="demo-badge"></a>
  13. </Badge>
  14. <Badge>
  15. <a href="#" class="demo-badge" style="margin-left: 32px"></a>
  16. <Icon type="md-time" slot="count" color="#ed4014" size="16" />
  17. </Badge>
  18. </template>
  19. <script>
  20. export default {
  21. }
  22. </script>

Badge 徽标数 - 图2

小红点

强迫症患者慎用!

  1. <template>
  2. <Badge dot>
  3. <a href="#" class="demo-badge"></a>
  4. </Badge>
  5. <Badge dot>
  6. <Icon type="ios-notifications-outline" size="26"></Icon>
  7. </Badge>
  8. <Badge dot>
  9. <a href="#">可以是一个链接</a>
  10. </Badge>
  11. </template>
  12. <script>
  13. export default {
  14. }
  15. </script>

Badge 徽标数 - 图3

封顶数字

通过设置overflow-count属性设置一个封顶值,当超过时,会显示${overflowCount}+

<template>
    <Badge :count="100">
        <a href="#" class="demo-badge"></a>
    </Badge>
    <Badge :count="1000" overflow-count="999">
        <a href="#" class="demo-badge"></a>
    </Badge>
</template>
<script>
    export default {

    }
</script>

Badge 徽标数 - 图4

独立使用及自定义样式

可以没有 slot 独立展示。

<style>
    .demo-badge-alone{
        background: #5cb85c !important;
    }
</style>
<template>
    <Badge :count="10"></Badge>
    <Badge :count="20" class-name="demo-badge-alone"></Badge>
</template>
<script>
    export default {

    }
</script>

Badge 徽标数 - 图5

自定义内容

设置 text 属性,可以自定义显示内容。

<template>
    <Row>
        <Col span="6">
            <Badge text="new">
                <a href="#" class="demo-badge"></a>
            </Badge>
        </Col>
        <Col span="6">
            <Badge text="hot">
                <a href="#" class="demo-badge"></a>
            </Badge>
        </Col>
    </Row>
</template>
<script>
    export default {

    }
</script>

Badge 徽标数 - 图6

状态点

用于表示状态的小圆点。

<template>
    <Badge status="success" />
    <Badge status="error" />
    <Badge status="default" />
    <Badge status="processing" />
    <Badge status="warning" />
    <br />
    <Badge status="success" text="Success" />
    <br />
    <Badge status="error" text="Error" />
    <br />
    <Badge status="default" text="Default" />
    <br />
    <Badge status="processing" text="Processing" />
    <br />
    <Badge status="warning" text="Warning" />
</template>
<script>
    export default {

    }
</script>

Badge 徽标数 - 图7

多彩徽标

4.0.0 属性 color 可以设置更多预设的状态点颜色,或者自定义颜色。

<template>
    <div>
        <strong>Presets:</strong>
        <br>
        <Badge color="blue" text="blue" />
        <Badge color="green" text="green" />
        <Badge color="red" text="red" />
        <Badge color="yellow" text="yellow" />
        <Badge color="pink" text="pink" />
        <Badge color="magenta" text="magenta" />
        <Badge color="volcano" text="volcano" />
        <Badge color="orange" text="orange" />
        <Badge color="gold" text="gold" />
        <Badge color="lime" text="lime" />
        <Badge color="cyan" text="cyan" />
        <Badge color="geekblue" text="geekblue" />
        <Badge color="purple" text="purple" />
        <br>
        <strong>Custom:</strong>
        <br>
        <Badge color="#2db7f5" text="#2db7f5" />
        <Badge color="#f50" text="#f50" />
    </div>
</template>
<script>
    export default {

    }
</script>

Badge 徽标数 - 图8

预设颜色

使用 type 属性,可以设置不同的颜色。

<template>
    <Badge :count="5" type="primary">
        <a href="#" class="demo-badge"></a>
    </Badge>
    <Badge :count="5" type="success">
        <a href="#" class="demo-badge"></a>
    </Badge>
    <Badge :count="5" type="normal">
        <a href="#" class="demo-badge"></a>
    </Badge>
    <Badge :count="5" type="info">
        <a href="#" class="demo-badge"></a>
    </Badge>
    <Badge :count="5" type="error">
        <a href="#" class="demo-badge"></a>
    </Badge>
    <Badge :count="5" type="warning">
        <a href="#" class="demo-badge"></a>
    </Badge>
</template>
<script>
    export default {

    }
</script>

API

Badge props

属性说明类型默认值
count显示的数字,大于overflowCount时,显示${overflowCount}+,为 0 时隐藏Number-
overflow-count展示封顶的数字值Number | String99
dot不展示数字,只有一个小红点,如需隐藏 dot ,需要设置count为 0 Booleanfalse
class-name自定义的class名称,dot 模式下无效String-
type使用预设的颜色,可选值为 success、primary、normal、error、warning、infoString-
show-zero当数值为 0 时,是否展示 BadgeBooleanfalse
status设置 Badge 为状态点,可选值为 success、processing、default、error、warningString-
text自定义内容,如果设置了 status,则为状态点的文本String-
offset设置状态点的位置偏移,格式为 [x, y]Array-
color 4.0.0设置更多状态点的颜色或自定义颜色String-

Badge slot

名称说明
count 4.0.0自定义角标显示内容(去角标背景),数值 count 将无效。
text 4.0.0自定义角标显示内容(带角标背景),数值 count 将无效。亦可自定义状态点模式下的 text 内容。