Badge徽标数
Badge
徽标数
使用import { Badge } from 'antd'; |
一般出现在通知图标或头像的右上角，用于显示需要处理的消息条数，通过醒目视觉形式吸引用户处理。
通用属性参考：通用属性
| 参数 | 说明 | 类型 | 默认值 | 版本 | 全局配置 |
|---|---|---|---|---|---|
| color | 自定义小圆点的颜色 | string | - | × | |
| count | 展示的数字，大于 overflowCount 时显示为 ${overflowCount}+，为 0 时隐藏 | ReactNode | - | × | |
| classNames | 用于自定义组件内部各语义化结构的 class，支持对象或函数 | Record<SemanticDOM, string> | (info: { props })=> Record<SemanticDOM, string> | - | 5.7.0 | |
| dot | 不展示数字，只有一个小红点 | boolean | false | × | |
| offset | 设置状态点的位置偏移 | [number, number] | - | × | |
| overflowCount | 展示封顶的数字值 | number | 99 | × | |
| showZero | 当数值为 0 时，是否展示 Badge | boolean | false | × | |
| size | 在设置了 count 的前提下有效，设置小圆点的大小 | medium | small | - | - | × |
| status | 设置 Badge 为状态点 | success | processing | default | error | warning | - | × | |
| styles | 用于自定义组件内部各语义化结构的行内 style，支持对象或函数 | Record<SemanticDOM, CSSProperties> | (info: { props })=> Record<SemanticDOM, CSSProperties> | - | 5.7.0 | |
| text | 在设置了 status 的前提下有效，设置状态点的文本 | ReactNode | - | × | |
| title | 设置鼠标放在状态点上时显示的文字。设置为 null 或 false 时移除原生 tooltip | string | null | false | - | 6.5.0 | × |
| 参数 | 说明 | 类型 | 默认值 | 版本 | 全局配置 |
|---|---|---|---|---|---|
| classNames | 用于自定义组件内部各语义化结构的 class，支持对象或函数 | Record<SemanticDOM, string> | (info: { props })=> Record<SemanticDOM, string> | - | 6.0.0 | |
| color | 自定义缎带的颜色 | string | - | × | |
| placement | 缎带的位置，start 和 end 随文字方向（RTL 或 LTR）变动 | start | end | end | × | |
| styles | 用于自定义组件内部各语义化结构的行内 style，支持对象或函数 | Record<SemanticDOM, CSSProperties> | (info: { props })=> Record<SemanticDOM, CSSProperties> | - | 6.0.0 | |
| text | 缎带中填入的内容 | ReactNode | - | × |
| Token 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| dotSize | 点状徽标尺寸 | number | 6 |
| indicatorHeight | 徽标高度 | string | number | 20 |
| indicatorHeightSM | 小号徽标高度 | string | number | 14 |
| indicatorZIndex | 徽标 z-index | string | number | auto |
| paddingInline | 多字符徽标水平内边距 | string | number | 8 |
| statusSize | 状态徽标尺寸 | number | 6 |
| textFontSize | 徽标文本尺寸 | number | 12 |
| textFontSizeSM | 小号徽标文本尺寸 | number | 12 |
| textFontWeight | 徽标文本粗细 | string | number | normal |
| Token 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| colorBorderBg | 控制元素背景边框的颜色。 | string | #ffffff |
| colorError | 用于表示操作失败的 Token 序列，如失败按钮、错误状态提示（Result）组件等。 | string | #ff4d4f |
| colorErrorHover | 错误色的深色悬浮态 | string | #ff7875 |
| colorInfo | 用于表示操作信息的 Token 序列，如 Alert 、Tag、 Progress 等组件都有用到该组梯度变量。 | string | #1677ff |
| colorInfoTextHover | 信息色的文本悬浮态。 | string | #4096ff |
| colorSuccess | 用于表示操作成功的 Token 序列，如 Result、Progress 等组件会使用该组梯度变量。 | string | #52c41a |
| colorText | 最深的文本色。为了符合W3C标准，默认的文本颜色使用了该色，同时这个颜色也是最深的中性色。 | string | rgba(0,0,0,0.88) |
| colorTextLightSolid | 控制带背景色的文本，例如 Primary Button 组件中的文本高亮颜色。 | string | #fff |
| colorTextPlaceholder | 控制占位文本的颜色。 | string | rgba(0,0,0,0.25) |
| colorWarning | 用于表示操作警告的 Token 序列，如 Notification、 Alert等警告类组件或 Input 输入类等组件会使用该组梯度变量。 | string | #faad14 |
| fontFamily | Ant Design 的字体家族中优先使用系统默认的界面字体，同时提供了一套利于屏显的备用字体库，来维护在不同平台以及浏览器的显示下，字体始终保持良好的易读性和可读性，体现了友好、稳定和专业的特性。 | string | -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji' |
| fontSize | 设计系统中使用最广泛的字体大小，文本梯度也将基于该字号进行派生。 | number | 14 |
| lineHeight | 文本行高 | number | 1.5714285714285714 |
| lineWidth | 用于控制组件边框、分割线等的宽度 | number | 1 |
| marginXS | 控制元素外边距，小尺寸。 | number | 8 |
| motionDurationMid | 动效播放速度，中速。用于中型元素动画交互 | string | 0.2s |
| motionDurationSlow | 动效播放速度，慢速。用于大型元素如面板动画交互 | string | 0.3s |
| motionEaseOutBack | 预设动效曲率 | string |