2016-07-11 11:45:42 +08:00
|
|
|
---
|
|
|
|
|
category: Components
|
2016-11-09 14:43:32 +08:00
|
|
|
type: Data Display
|
2016-09-21 11:28:38 +08:00
|
|
|
title: Badge
|
2020-05-31 11:48:34 +08:00
|
|
|
cover: https://gw.alipayobjects.com/zos/antfincdn/6%26GF9WHwvY/Badge.svg
|
2016-07-11 11:45:42 +08:00
|
|
|
---
|
|
|
|
|
|
2017-09-16 11:29:38 +08:00
|
|
|
Small numerical value or status descriptor for UI elements.
|
2016-07-11 11:45:42 +08:00
|
|
|
|
2016-09-10 13:43:30 +08:00
|
|
|
## When To Use
|
2016-07-11 11:45:42 +08:00
|
|
|
|
2017-09-16 11:29:38 +08:00
|
|
|
Badge normally appears in proximity to notifications or user avatars with eye-catching appeal, typically displaying unread messages count.
|
2016-07-11 11:45:42 +08:00
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
2019-03-31 20:21:20 +08:00
|
|
|
| Property | Description | Type | Default | Version |
|
2019-05-07 14:57:32 +08:00
|
|
|
| --- | --- | --- | --- | --- |
|
2019-11-20 20:31:43 +08:00
|
|
|
| color | Customize Badge dot color | string | - | |
|
2019-05-07 14:57:32 +08:00
|
|
|
| count | Number to show in badge | ReactNode | | |
|
|
|
|
|
| dot | Whether to display a red dot instead of `count` | boolean | `false` | |
|
2020-06-06 13:20:09 +08:00
|
|
|
| offset | set offset of the badge dot | `[number, number]` | - | |
|
2019-05-07 14:57:32 +08:00
|
|
|
| overflowCount | Max count to show | number | 99 | |
|
|
|
|
|
| showZero | Whether to show badge when `count` is zero | boolean | `false` | |
|
2020-06-17 23:18:14 +08:00
|
|
|
| status | Set Badge as a status dot | `success` \| `processing` \| `default` \| `error` \| `warning` | | |
|
|
|
|
|
| text | If `status` is set, `text` sets the display text of the status `dot` | string | | |
|
2019-11-20 20:31:43 +08:00
|
|
|
| title | Text to show when hovering over the badge | string | `count` | |
|
