• Badge 徽标数
    • 概述
    • 代码示例
    • API
      • Badge props
      • Badge slot

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