2017-05-28 14:20:59 +08:00
|
|
|
|
---
|
|
|
|
|
category: Components
|
|
|
|
|
subtitle: 头像
|
2018-11-04 16:20:35 +08:00
|
|
|
|
type: 数据展示
|
2017-05-28 14:20:59 +08:00
|
|
|
|
title: Avatar
|
2020-05-31 11:48:34 +08:00
|
|
|
|
cover: https://gw.alipayobjects.com/zos/antfincdn/aBcnbw68hP/Avatar.svg
|
2017-05-28 14:20:59 +08:00
|
|
|
|
---
|
|
|
|
|
|
2017-06-09 15:00:44 +08:00
|
|
|
|
用来代表用户或事物,支持图片、图标或字符展示。
|
2017-05-28 14:20:59 +08:00
|
|
|
|
|
2018-08-31 17:03:27 +08:00
|
|
|
|
## 设计师专属
|
2018-08-29 10:51:21 +08:00
|
|
|
|
|
2020-10-19 16:45:17 +08:00
|
|
|
|
安装 [Kitchen Sketch 插件 💎](https://kitchen.alipay.com),一键填充高逼格头像和文本。
|
2018-08-29 10:51:21 +08:00
|
|
|
|
|
2017-05-28 14:20:59 +08:00
|
|
|
|
## API
|
|
|
|
|
|
2020-07-13 12:45:37 +08:00
|
|
|
|
### Avatar
|
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
2020-10-21 10:33:43 +08:00
|
|
|
|
| alt | 图像无法显示时的替代文本 | string | - | |
|
|
|
|
|
| gap | 字符类型距离左右两侧边界单位像素 | number | 4 | 4.3.0 |
|
2019-08-13 14:07:17 +08:00
|
|
|
|
| icon | 设置头像的自定义图标 | ReactNode | - | |
|
2020-01-17 17:23:48 +08:00
|
|
|
|
| shape | 指定头像的形状 | `circle` \| `square` | `circle` | |
|
2020-08-29 13:43:52 +08:00
|
|
|
|
| size | 设置头像的大小 | number \| `large` \| `small` \| `default` \| `{ xs: number, sm: number, ...}` | `default` | 4.7.0 |
|
2019-07-11 14:14:33 +08:00
|
|
|
|
| src | 图片类头像的资源地址 | string | - | |
|
2019-11-20 20:31:43 +08:00
|
|
|
|
| srcSet | 设置图片类头像响应式资源地址 | string | - | |
|
|
|
|
|
| onError | 图片加载失败的事件,返回 false 会关闭组件默认的 fallback 行为 | () => boolean | - | |
|
2020-06-12 15:26:40 +08:00
|
|
|
|
|
|
|
|
|
> Tip:你可以设置 `icon` 或 `children` 作为图片加载失败的默认 fallback 行为,优先级为 `icon` > `children`
|
2020-07-13 12:45:37 +08:00
|
|
|
|
|
|
|
|
|
### Avatar.Group (4.5.0+)
|
|
|
|
|
|
2020-10-21 10:33:43 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| maxCount | 显示的最大头像个数 | number | - | |
|
|
|
|
|
| maxPopoverPlacement | 多余头像气泡弹出位置 | `top` \| `bottom` | `top` | |
|
|
|
|
|
| maxStyle | 多余头像样式 | CSSProperties | - | |
|