- Avatar 头像
- 概述
- 代码示例
- API
- Avatar props
- Avatar events
Avatar 头像
概述
用来代表用户或事物,支持图片、图标或字符展示。
代码示例

基础用法
头像有三种尺寸,两种形状可选。
<template><div><div class="demo-avatar"><Avatar icon="ios-person" size="large" /><Avatar icon="ios-person" /><Avatar icon="ios-person" size="small" /></div><div class="demo-avatar"><Avatar shape="square" icon="ios-person" size="large" /><Avatar shape="square" icon="ios-person" /><Avatar shape="square" icon="ios-person" size="small" /></div></div></template><script>export default {}</script>

类型
支持三种类型:图片、Icon 以及字符,其中 Icon 和字符型可以自定义图标颜色及背景色。
<template><div class="demo-avatar"><Avatar icon="ios-person" /><Avatar>U</Avatar><Avatar>USER</Avatar><Avatar src="https://i.loli.net/2017/08/21/599a521472424.jpg" /><Avatar style="color: #f56a00;background-color: #fde3cf">U</Avatar><Avatar style="background-color: #87d068" icon="ios-person" /></div></template><script>export default {}</script>

带徽标的头像
通常用于消息提示。
<template><div class="demo-avatar-badge"><Badge :count="1"><Avatar shape="square" icon="ios-person" /></Badge><Badge dot><Avatar shape="square" icon="ios-person" /></Badge></div></template><script>export default {}</script>

自动调整字符大小
对于字符型的头像,当字符串较长时,字体大小可以根据头像宽度自动调整。
<template><div class="demo-avatar"><Avatar :style="{background: color}">{{ user }}</Avatar><Button size="small" @click="handleChange">Change</Button></div></template><script>const UserList = ['U', 'Lucy', 'Tom', 'Edward'];const ColorList = ['#f56a00', '#7265e6', '#ffbf00', '#00a2ae'];export default {data () {return {user: UserList[0],color: ColorList[0]}},methods: {handleChange () {const index = UserList.indexOf(this.user);this.user = index < UserList.length - 1 ? UserList[index + 1] : UserList[0];this.color = index < ColorList.length - 1 ? ColorList[index + 1] : ColorList[0];}}}</script>
API
Avatar props
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| shape | 指定头像的形状,可选值为 circle、square | String | circle |
| size | 设置头像的大小,可选值为 large、small、default | String | default |
| src | 图片类头像的资源地址 | String | - |
| icon | 设置头像的图标类型,参考 Icon 组件 | String | - |
| custom-icon | 自定义图标 | String | - |
Avatar events
| 事件名 | 说明 | 返回值 |
|---|---|---|
| on-error 3.3.0 | 在设置 src 且图片加载不成功时触发 | event |
