Avatar 头像

Avatar 头像

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

基础用法

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

<template>
  <el-row class="demo-avatar demo-basic">
    <el-col :span="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 :span="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);
}
</style>

展示类型

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

<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>

回退行为

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

<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 属性一致

<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'
const state = reactive({
  fits: ['fill', 'contain', 'cover', 'none', 'scale-down'],
  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>

Avatar API

Avatar 属性

名称	说明	类型	默认值	是否必需
`icon`	设置 Avatar 的图标类型，具体参考 Icon 组件	`string \| Component`	—	否
`size`	Avatar 大小	`number \| ‘large’ \| ‘default’ \| ‘small’`	`‘default’`	否
`shape`	Avatar 形状	`‘circle’ \| ‘square’`	`‘circle’`	否
`src`	Avatar 图片的源地址	`string`	—	否
`src-set`	图片 Avatar 的原生 `srcset` 属性	`string`	—	否
`alt`	图片 Avatar 的原生 `alt` 属性	`string`	—	否
`fit`	当展示类型为图片的时候，设置图片如何适应容器	`‘fill’ \| ‘contain’ \| ‘cover’ \| ‘none’ \| ‘scale-down’`	`‘cover’`	否