mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-06 02:15:35 +08:00
a73abb9487
* feat: Badge.Ribbon, wip * feat: Badge.Ribbon * test: Badge.Ribbon * chore * test: update snapshot * fix: Badge.RibbonStyle IE 11 * chore * docs * chore * chore * refactor * docs * refactor: remove placement left & right * Update components/badge/index.zh-CN.md Co-authored-by: xrkffgg <xrkffgg@gmail.com> * Update components/badge/index.en-US.md Co-authored-by: xrkffgg <xrkffgg@gmail.com> * docs: demo change * docs * refactor: use css * refactor: use css rtl * refactor Co-authored-by: xrkffgg <xrkffgg@gmail.com>
37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
---
|
|
category: Components
|
|
type: Data Display
|
|
title: Badge
|
|
cover: https://gw.alipayobjects.com/zos/antfincdn/6%26GF9WHwvY/Badge.svg
|
|
---
|
|
|
|
Small numerical value or status descriptor for UI elements.
|
|
|
|
## When To Use
|
|
|
|
Badge normally appears in proximity to notifications or user avatars with eye-catching appeal, typically displaying unread messages count.
|
|
|
|
## API
|
|
|
|
### Badge
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| color | Customize Badge dot color | string | - | |
|
|
| count | Number to show in badge | ReactNode | - | |
|
|
| dot | Whether to display a red dot instead of `count` | boolean | false | |
|
|
| offset | Set offset of the badge dot | \[number, number] | - | |
|
|
| overflowCount | Max count to show | number | 99 | |
|
|
| showZero | Whether to show badge when `count` is zero | boolean | false | |
|
|
| 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` | ReactNode | - | |
|
|
| title | Text to show when hovering over the badge | string | - | |
|
|
|
|
### Badge.Ribbon (4.5.0+)
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
| --- | --- | --- | --- | --- |
|
|
| color | Customize Ribbon color | string | - | |
|
|
| placement | The placement of the Ribbon, `start` and `end` follow text direction (RTL or LTR) | `start` \| `end` | `end` | |
|
|
| text | Content inside the Ribbon | ReactNode | - | |
|