Avatar 头像
头像可用于表示人物或物体。 支持图片、图标或字符。
基础用法
使用 shape
和 size
属性来设置头像的形状和大小。
圆形




方形




vue
<template>
<el-row class="demo-avatar demo-basic">
<el-col :lg="12" :md="12">
<div class="sub-title">circle</div>
<div class="demo-basic--circle">
<div class="block">
<el-avatar :size="50" :src="circleUrl" />
</div>
<div v-for="size in sizeList" :key="size" class="block">
<el-avatar :size="size" :src="circleUrl" />
</div>
</div>
</el-col>
<el-col :lg="12" :md="12">
<div class="sub-title">square</div>
<div class="demo-basic--circle">
<div class="block">
<el-avatar shape="square" :size="50" :src="squareUrl" />
</div>
<div v-for="size in sizeList" :key="size" class="block">
<el-avatar shape="square" :size="size" :src="squareUrl" />
</div>
</div>
</el-col>
</el-row>
</template>
<script lang="ts" setup>
import { reactive, toRefs } from 'vue'
const state = reactive({
circleUrl:
'https://cube.elemecdn.com/3/7c/3ea6beec64369c2642b92c6726f1epng.png',
squareUrl:
'https://cube.elemecdn.com/9/c2/f0ee8a3c7c9638a54940382568c9dpng.png',
sizeList: ['small', '', 'large'] as const,
})
const { circleUrl, squareUrl, sizeList } = toRefs(state)
</script>
<style scoped>
.demo-basic {
text-align: center;
}
.demo-basic .sub-title {
margin-bottom: 10px;
font-size: 14px;
color: var(--el-text-color-secondary);
}
.demo-basic .demo-basic--circle,
.demo-basic .demo-basic--square {
display: flex;
justify-content: space-between;
align-items: center;
}
.demo-basic .block:not(:last-child) {
border-right: 1px solid var(--el-border-color);
}
.demo-basic .block {
flex: 1;
}
.demo-basic .el-col:not(:last-child) {
border-right: 1px solid var(--el-border-color);
}
@media screen and (max-width: 992px) {
.demo-basic .el-col:not(:last-child) {
border-right: none;
}
}
</style>
隐藏源代码
类型
支持图片、图标或字符。

用户
vue
<template>
<div class="demo-type">
<div>
<el-avatar :icon="UserFilled" />
</div>
<div>
<el-avatar
src="https://cube.elemecdn.com/0/88/03b0d39583f48206768a7534e55bcpng.png"
/>
</div>
<div>
<el-avatar> user </el-avatar>
</div>
</div>
</template>
<script setup lang="ts">
import { UserFilled } from '@element-plus/icons-vue'
</script>
<style scoped>
.demo-type {
display: flex;
}
.demo-type > div {
flex: 1;
text-align: center;
}
.demo-type > div:not(:last-child) {
border-right: 1px solid var(--el-border-color);
}
</style>
隐藏源代码
回退
图片加载失败时的回退行为。
vue
<template>
<div class="demo-type">
<el-avatar :size="60" src="https://empty" @error="errorHandler">
<img
src="https://cube.elemecdn.com/e/fd/0fc7d20532fdaf769a25683617711png.png"
/>
</el-avatar>
</div>
</template>
<script lang="ts" setup>
const errorHandler = () => true
</script>
隐藏源代码
适应容器
设置图片如何适应其容器,与 object-fit 的效果相同。
填充

包含

覆盖

无

缩小

vue
<template>
<div class="demo-fit">
<div v-for="fit in fits" :key="fit" class="block">
<span class="title">{{ fit }}</span>
<el-avatar shape="square" :size="100" :fit="fit" :src="url" />
</div>
</div>
</template>
<script lang="ts" setup>
import { reactive, toRefs } from 'vue'
import type { ObjectFitProperty } from 'csstype'
const state = reactive({
fits: [
'fill',
'contain',
'cover',
'none',
'scale-down',
] as ObjectFitProperty[],
url: 'https://fuss10.elemecdn.com/e/5d/4a731a90594a4af544c0c25941171jpeg.jpeg',
})
const { fits, url } = toRefs(state)
</script>
<style scoped>
.demo-fit {
display: flex;
text-align: center;
justify-content: space-between;
}
.demo-fit .block {
flex: 1;
display: flex;
flex-direction: column;
flex-grow: 0;
}
.demo-fit .title {
margin-bottom: 10px;
font-size: 14px;
color: var(--el-text-color-secondary);
}
</style>
隐藏源代码
API
属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
icon | 将展示类型设置为图标,更多信息请参见图标组件。 | string / Component | — |
size | 头像尺寸。 | 数字 / 枚举 | default |
shape | 头像形状。 | 枚举 | 圆形 |
src | 图片头像的图片源。 | string | — |
src-set | 图片头像的原生 srcset 属性。 | string | — |
alt | 图片头像的原生 alt 属性。 | string | — |
fit | 设置图片如何适应其容器。 | 枚举 | 覆盖 |
事件
名称 | 描述 | 类型 |
---|---|---|
error | 图片加载失败时触发。 | Function |
插槽
名称 | 描述 |
---|---|
default | 自定义头像内容。 |