Avatar 头像 ​

Avatar 组件可以用来代表人物或对象, 支持使用图片、图标或者文字作为 Avatar。

基础用法 ​

使用 shape 和 size 属性来设置 Avatar 的形状和大小。

circle
square

展示类型 ​

支持使用图片,图标或者文字作为 Avatar。

user

回退行为 ​

图片加载失败时的回退行为。

适应容器 ​

当使用图片作为用户头像时,设置该图片如何在容器中展示。与 object-fit 属性一致

fill
contain
cover
none
scale-down

头像组 2.13.1 ​

显示为头像组

使用标签 <el-avatar-group> 来分组您的头像。

default

use collapse-avatars

+ 4

use collapse-class and collapse-style

+ 4

use max-collapse-avatars

+ 2

use collapse-avatars-tooltip

+ 2

Avatar API ​

Avatar 属性 ​

名称说明类型默认值
icon设置 Avatar 的图标类型,具体参考 Icon 组件string / Component—
sizeAvatar 大小number / enum—
shapeAvatar 形状enum—
srcAvatar 图片的源地址string—
src-set图片 Avatar 的原生 srcset 属性stringstring
alt图片 Avatar 的原生 alt 属性string—
fit当展示类型为图片的时候,设置图片如何适应容器enumcover

Avatar 事件 ​

名称说明类型
error图片加载失败时触发Function

Avatar 插槽 ​

插槽名说明
default自定义头像展示内容

AvatarGroup API 2.13.1 ​

AvatarGroup Attributes ​

方法名详情Type默认
size控制头像组中的头像大小number / enum—
shape控制头像组中的头像形状enum—
collapse-avatars是否折叠头像booleanfalse
collapse-avatars-tooltip是否在鼠标悬停折叠头像的文字时显示所有折叠头像。 若要使用此功能, collapse-avatars 必须为 truebooleanfalse
max-collapse-avatars需要显示的头像的最大数量 若要使用此功能, collapse-avatars 必须为 truenumber1
effecttooltip 主题,内置了 dark / light 两种enum / stringlight
placementtooltip 的位置enumtop
popper-classtooltip 的自定义类名string''
popper-styletooltip 的自定义样式string / object—
collapse-classcollapse-avatar 的自定义类名string''
collapse-stylecollapse-avatar 的自定义样式string / object—

源代码 ​

组件 • 样式 • 文档

贡献者 ​