Avatar 头像

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

基础用法

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

circle
avatar
avatar
avatar
avatar
square
avatar
avatar
avatar
avatar

展示类型

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

avatar
user

回退行为

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

avatar

适应容器

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

fillavatar
containavatar
coveravatar
noneavatar
scale-downavatar

头像组 2.13.1

显示为头像组

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

default

avataravataravataravataravatar

use collapse-avatars

avatar+ 4

use collapse-class and collapse-style

avatar+ 4

use max-collapse-avatars

avataravataravatar+ 2

use collapse-avatars-tooltip

avataravataravatar+ 2

Avatar API

Avatar Attributes

属性名说明类型默认值
size尺寸,数字按 px 处理,也可传尺寸名number / enum—
shape形状enumcircle
icon图标,图片加载失败时回退显示Component—
src图片地址string—
alt原生 altstring—
src-set原生 srcSetstring—
fit图片填充方式enumcover

Avatar Events

事件名说明参数
onError图片加载失败时触发Function

AvatarGroup Attributes

属性名说明类型默认值
size统一尺寸,下发到组内 Avatarnumber / string—
shape统一形状,下发到组内 Avatarenum—
collapse-avatars是否折叠超出的头像booleanfalse
collapse-avatars-tooltip悬浮折叠头像时展示全部被折叠的头像booleanfalse
max-collapse-avatars最多展示的头像数量number1
effect折叠提示主题enumlight
placement折叠提示位置enum placementtop
popper-class / popper-style折叠提示的自定义类名与样式string / object—
collapse-class / collapse-style折叠头像的类名与样式string / object—