Avatar头像 - 图1

Avatar头像

用来代表用户或事物,支持图片、图标或字符展示。

设计师专属

安装 Kitchen Sketch 插件 �,一键填充高逼格头像和文本.

代码演示

Avatar头像 - 图2

基本

头像有三种尺寸,两种形状可选。

  1. <template>
  2. <div>
  3. <div>
  4. <a-avatar :size="64" icon="user" />
  5. <a-avatar size="large" icon="user" />
  6. <a-avatar icon="user" />
  7. <a-avatar size="small" icon="user" />
  8. </div>
  9. <br />
  10. <div>
  11. <a-avatar shape="square" :size="64" icon="user" />
  12. <a-avatar shape="square" size="large" icon="user" />
  13. <a-avatar shape="square" icon="user" />
  14. <a-avatar shape="square" size="small" icon="user" />
  15. </div>
  16. </div>
  17. </template>

Avatar头像 - 图3

类型

支持三种类型:图片、Icon 以及字符,其中 Icon 和字符型可以自定义图标颜色及背景色。

  1. <template>
  2. <div>
  3. <a-avatar icon="user" />
  4. <a-avatar>
  5. <a-icon slot="icon" type="user" />
  6. </a-avatar>
  7. <a-avatar>U</a-avatar>
  8. <a-avatar>USER</a-avatar>
  9. <a-avatar src="https://zos.alipayobjects.com/rmsportal/ODTLcjxAfvqbxHnVXCYX.png" />
  10. <a-avatar style="color: #f56a00; backgroundColor: #fde3cf">
  11. U
  12. </a-avatar>
  13. <a-avatar style="backgroundColor:#87d068" icon="user" />
  14. </div>
  15. </template>

Avatar头像 - 图4

带徽标的头像

通常用于消息提示。

  1. <template>
  2. <div>
  3. <span style="margin-right:24px">
  4. <a-badge :count="1"><a-avatar shape="square" icon="user"/></a-badge>
  5. </span>
  6. <span>
  7. <a-badge dot><a-avatar shape="square" icon="user"/></a-badge>
  8. </span>
  9. </div>
  10. </template>

Avatar头像 - 图5

自动调整字符大小

对于字符型的头像,当字符串较长时,字体大小可以根据头像宽度自动调整。

  1. <template>
  2. <div>
  3. <a-avatar
  4. shape="square"
  5. size="large"
  6. :style="{ backgroundColor: color, verticalAlign: 'middle' }"
  7. >
  8. {{ avatarValue }}
  9. </a-avatar>
  10. <a-button
  11. size="small"
  12. :style="{ marginLeft: 16, verticalAlign: 'middle' }"
  13. @click="changeValue"
  14. >
  15. 改变
  16. </a-button>
  17. </div>
  18. </template>
  19. <script>
  20. const UserList = ['U', 'Lucy', 'Tom', 'Edward'];
  21. const colorList = ['#f56a00', '#7265e6', '#ffbf00', '#00a2ae'];
  22. export default {
  23. data() {
  24. return {
  25. avatarValue: UserList[0],
  26. color: colorList[0],
  27. };
  28. },
  29. methods: {
  30. changeValue() {
  31. const index = UserList.indexOf(this.avatarValue);
  32. this.avatarValue = index < UserList.length - 1 ? UserList[index + 1] : UserList[0];
  33. this.color = index < colorList.length - 1 ? colorList[index + 1] : colorList[0];
  34. },
  35. },
  36. };
  37. </script>

API

参数说明类型默认值
icon设置头像的图标类型,可设为 Icon 的 type 或 VNodestring | VNode | slot-
shape指定头像的形状Enum{ ‘circle’, ‘square’ }circle
size设置头像的大小number | Enum{ ‘large’, ‘small’, ‘default’ }default
src图片类头像的资源地址string-
srcSet设置图片类头像响应式资源地址string-
alt图像无法显示时的替代文本string-
loadError图片加载失败的事件,返回 false 会关闭组件默认的 fallback 行为() => boolean-