Skip to content

Avatar 头像

头像组件用于展示用户或事物的头像,支持图片、图标和文字三种显示方式。

基础用法

头像的基础用法,支持图片、图标和文字三种显示方式。

U

尺寸

头像支持多种尺寸,包括预设尺寸和自定义数值。

形状

头像支持圆形和方形两种形状。

图片适应

当使用图片头像时,可以设置图片的适应方式。

自定义颜色

可以自定义头像的背景色、文字颜色和图标颜色。

V
K

图片加载失败

当图片加载失败时,可以显示回退内容。

可点击

设置 clickable 属性使头像可点击。

预览功能

启用 preview 属性可以点击头像预览大图。

懒加载

启用 lazy 属性可以实现图片懒加载。

圆角半径

当形状为方形时,可以设置圆角半径。

API

Avatar Props

名称类型默认值说明
size'small' | 'default' | 'large' | number'default'头像大小
shape'circle' | 'square''circle'头像形状
srcstring图片地址
altstring图片替代文本
iconstring图标名称
fit'fill' | 'contain' | 'cover' | 'none' | 'scale-down''cover'图片适应方式
lazybooleanfalse是否懒加载图片
previewbooleanfalse是否启用图片预览功能
placeholderstring图片加载时显示的占位符
clickablebooleanfalse是否可点击
backgroundColorstring背景颜色
colorstring文字颜色
iconColorstring图标颜色
iconSizenumber图标大小
borderstring边框样式
radiusstring | number圆角半径(方形时有效)
fallbackstring图片加载失败时的回退文本

Avatar Events

事件名说明回调参数
click点击头像时触发(event: MouseEvent)
error图片加载失败时触发(event: Event)
load图片加载成功时触发(event: Event)

Avatar Slots

插槽名说明
default默认内容

基于 MIT 协议发布