Avatar 头像

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

基础用法

使用 shapesize 属性来设置 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是否折叠头像boolean你好
collapse-avatars-tooltip是否在鼠标悬停折叠头像的文字时显示所有折叠头像。 若要使用此功能, collapse-avatars 必须为 trueboolean你好
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:::

源代码

组件样式文档

贡献者