头像

头像可用于表示人或物。支持图片、图标或字符。

基础用法

使用 shapesize 属性设置头像的形状和尺寸。

圆形
方形

类型

支持图片、图标或字符。

用户

加载失败

图片加载失败时的占位符。

填充模式

设置图片头像如何适应其容器,与 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是否折叠头像booleanfalse
collapse-avatars-tooltip鼠标悬停在折叠头像文本时是否显示所有折叠的头像。使用此属性,collapse-avatars 必须为 true。booleanfalse
max-collapse-avatars最多显示的头像数量。使用此属性,collapse-avatars 必须为 true。number1
effecttooltip 主题,内置主题:`dark` / `light`enum / stringlight
placement提示框的展示位置枚举
popper-class提示框的自定义类名string''
popper-style提示框的自定义样式string / object
collapse-class折叠头像的自定义类名string''
collapse-style折叠头像的自定义样式string / object

来源

组件样式文档

贡献者