头像
头像可用于表示人或物。支持图片、图标或字符。
基础用法
使用 shape 和 size 属性设置头像的形状和尺寸。
类型
支持图片、图标或字符。
加载失败
图片加载失败时的占位符。
填充模式
设置图片头像如何适应其容器,与 object-fit 相同。
头像组 2.13.1
以头像组的形式展示。
使用 <el-avatar-group> 标签将头像分组。
default





使用 collapse-avatars
+ 4使用 collapse-class 和 collapse-style
+ 4使用 max-collapse-avatars


+ 2使用 collapse-avatars-tooltip


+ 2头像 API
头像属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| icon | 将表示类型设置为图标,更多信息请查看图标组件。 | string / Component | — |
| size | 头像尺寸。 | number / 枚举 | — |
| shape | 头像形状。 | 枚举 | — |
| src | 图片头像的图片源地址。 | string | — |
| src-set | 图片头像的原生 srcset 属性。 | string | — |
| alt | 图片头像的原生 alt 属性。 | string | — |
| fit | 设置图片头像如何适应其容器。 | 枚举 | 覆盖 |
头像事件
| 名称 | 描述 | 类型 |
|---|---|---|
| error | 图片加载失败时触发。 | Function |
头像插槽
| 名称 | 描述 |
|---|---|
| default | 自定义头像内容。 |
头像组 API 2.13.1
头像组属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| size | 控制此头像组中头像的尺寸。 | number / 枚举 | — |
| shape | 控制此头像组中头像的形状。 | 枚举 | — |
| collapse-avatars | 是否折叠头像 | boolean | false |
| collapse-avatars-tooltip | 鼠标悬停在折叠头像文本时是否显示所有折叠的头像。使用此属性,collapse-avatars 必须为 true。 | boolean | false |
| max-collapse-avatars | 最多显示的头像数量。使用此属性,collapse-avatars 必须为 true。 | number | 1 |
| effect | tooltip 主题,内置主题:`dark` / `light` | enum / string | light |
| placement | 提示框的展示位置 | 枚举 | 上 |
| popper-class | 提示框的自定义类名 | string | '' |
| popper-style | 提示框的自定义样式 | string / object | — |
| collapse-class | 折叠头像的自定义类名 | string | '' |
| collapse-style | 折叠头像的自定义样式 | string / object | — |


