Avatar头像
Avatar
头像
用来代表用户或事物，支持图片、图标或字符展示。
使用import{ Avatar }from"antd"; |
文档编辑此页 |
- 组件总览
- 通用
- 布局
- 导航
- 数据录入
- 数据展示
- 反馈
- 其他
头像有三种尺寸，两种形状可选。
对于字符型的头像，当字符串较长时，字体大小可以根据头像宽度自动调整。也可使用 gap 来设置字符距离左右两侧边界单位像素。
K+2头像组合展现。
头像大小可以根据屏幕大小自动调整。
Component Token Debug.
支持三种类型：图片、Icon 以及字符，其中 Icon 和字符型可以自定义图标颜色及背景色。
通常用于消息提示。
切换 Avatar 显示的时候，文本样式应该居中并正确调整字体大小。
图片不存在时，如果 src 本身是个 ReactElement，会尝试回退到 src，否则尝试回退到 icon，最后回退到显示 children。
通用属性参考：通用属性
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| alt | 图像无法显示时的替代文本 | string | - | |
| gap | 字符类型距离左右两侧边界单位像素 | number | 4 | 4.3.0 |
| icon | 设置头像的自定义图标 | ReactNode | - | |
| shape | 指定头像的形状 | circle | square | circle | |
| size | 设置头像的大小 | number | large | small | default | { xs: number, sm: number, ...} | default | 4.7.0 |
| src | 图片类头像的资源地址或者图片元素 | string | ReactNode | - | ReactNode: 4.8.0 |
| srcSet | 设置图片类头像响应式资源地址 | string | - | |
| draggable | 图片是否允许拖动 | boolean | 'true' | 'false' | true | |
| crossOrigin | CORS 属性设置 | 'anonymous' | 'use-credentials' | '' | - | 4.17.0 |
| onError | 图片加载失败的事件，返回 false 会关闭组件默认的 fallback 行为 | () => boolean | - |
Tip：你可以设置
icon或children作为图片加载失败的默认 fallback 行为，优先级为icon>children
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| max | 设置最多显示相关配置，5.18.0 前可使用 参数 | { count?: number; style?: CSSProperties; popover?: PopoverProps } | - | 5.18.0 |
| size | 设置头像的大小 | number | large | small | default | { xs: number, sm: number, ...} | default | 4.8.0 |
| shape | 设置头像的形状 | circle | square | circle | 5.8.0 |
| Token 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| containerSize | 头像尺寸 | number | 32 |
| containerSizeLG | 大号头像尺寸 | number | 40 |
| containerSizeSM | 小号头像尺寸 | number | 24 |
| groupBorderColor | 头像组边框颜色 | string | #ffffff |
| groupOverlapping | 头像组重叠宽度 | number | -8 |
| groupSpace | 头像组间距 | number | 4 |
| textFontSize | 头像文字大小 | number | 18 |
| textFontSizeLG | 大号头像文字大小 | number | 24 |
| textFontSizeSM | 小号头像文字大小 | number | 14 |
