mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-16 01:41:02 +08:00
882cec62d6
* docs: Add components overview page * fix detail * remove ContributorsList form overview page * fix components url * improve code style * remove extra file * fix detail * fix lint * fix lint * docs: Finish components overview page * fix lint * docs: Update cover * fix lint * update cover * update menu * improve overview page * refactor code * fix order * update title * add components count * fix overview page ssr bug * move less file * update title margin Co-authored-by: arvinxx <arvinx@foxmail.com>
38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
---
|
|
category: Components
|
|
subtitle: 徽标数
|
|
type: 数据展示
|
|
title: Badge
|
|
cover: https://gw.alipayobjects.com/zos/antfincdn/6%26GF9WHwvY/Badge.svg
|
|
---
|
|
|
|
图标右上角的圆形徽标数字。
|
|
|
|
## 何时使用
|
|
|
|
一般出现在通知图标或头像的右上角，用于显示需要处理的消息条数，通过醒目视觉形式吸引用户处理。
|
|
|
|
## API
|
|
|
|
```jsx
|
|
<Badge count={5}>
|
|
<a href="#" className="head-example" />
|
|
</Badge>
|
|
```
|
|
|
|
```jsx
|
|
<Badge count={5} />
|
|
```
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
| --- | --- | --- | --- | --- |
|
|
| color | 自定义小圆点的颜色 | string | - | |
|
|
| count | 展示的数字，大于 overflowCount 时显示为 `${overflowCount}+`，为 0 时隐藏 | ReactNode | | |
|
|
| dot | 不展示数字，只有一个小红点 | boolean | false | |
|
|
| offset | 设置状态点的位置偏移，格式为 `[x, y]` | `[number, number]` | - | |
|
|
| overflowCount | 展示封顶的数字值 | number | 99 | |
|
|
| showZero | 当数值为 0 时，是否展示 Badge | boolean | false | |
|
|
| status | 设置 Badge 为状态点 | `success` \| `processing` \| `default` \| `error` \| `warning` | '' | |
|
|
| text | 在设置了 `status` 的前提下有效，设置状态点的文本 | string | '' | |
|
|
| title | 设置鼠标放在状态点上时显示的文字 | string | `count` | |
|