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
|
2016-07-11 11:45:42 +08:00
|
|
|
---
|
|
|
|
|
|
|
|
Small numerical value or status descriptors for UI elements.
|
|
|
|
|
2016-09-10 13:43:30 +08:00
|
|
|
## When To Use
|
2016-07-11 11:45:42 +08:00
|
|
|
|
|
|
|
Badge normally appears in proximity to notification or head picture with eye-catching appeal, typically displaying unread messages count.
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
<Badge count={5}>
|
2016-08-23 21:00:35 +08:00
|
|
|
<a href="#" className="head-example" />
|
2016-07-11 11:45:42 +08:00
|
|
|
</Badge>
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
<Badge count={5} />
|
|
|
|
```
|
|
|
|
|
|
|
|
| Property | Description | Type | Default |
|
|
|
|
|----------------|-------------------------|------------|---------|
|
2017-01-20 20:10:50 +08:00
|
|
|
| count | Number to show in badge | number | |
|
|
|
|
| overflowCount | Max count to show | number | 99 |
|
2017-03-01 11:16:58 +08:00
|
|
|
| showZero | Whether to show badge when `count` is zero | boolean | false |
|
2017-01-20 20:10:50 +08:00
|
|
|
| dot | Whether to show red dot without number | boolean | false |
|
2016-08-20 17:43:46 +08:00
|
|
|
| status | Set Badge as a status dot | Enum{ 'success', 'processing, 'default', 'error', 'warning' } | '' |
|
2017-01-20 20:10:50 +08:00
|
|
|
| text | If `status` is set, `text` is to set the text of status dot | string | '' |
|