Avatar 头像 ​

用于展示用户或对象,支持图片、图标或文字。

基础用法 ​

通过 shape、size 设置形状与尺寸。支持四种尺寸:small (24px)、default (32px)、medium (40px)、large (56px)。

circle
square

类型 ​

支持图片、图标或文字。

user

自定义背景颜色 ​

通过 bg-color 属性设置自定义背景颜色,支持任何有效的 CSS 颜色值。

User

加载失败 ​

图片加载失败时的占位处理。

适应容器 ​

设置图片头像如何适应容器,同原生 CSS object-fit。

fill
contain
cover
none
scale-down

头像组 ​

以头像组形式展示。

使用 <u-avatar-group> 包裹多个头像。

default

use collapse-avatars

+4

use collapse-class and collapse-style

+4

use max-collapse-avatars

+2

use collapse-avatars-tooltip

+2

头像 API ​

头像 属性 ​

名称说明类型默认值
icon图标类型,详见图标组件string / Component—
size尺寸number / enum—
shape形状enum—
src图片头像地址string—
src-set图片原生 srcsetstring—
alt图片原生 altstring—
fit图片头像的适应方式enumcover
bg-color自定义背景颜色string—

头像 事件 ​

事件名说明类型
error图片加载失败时Function

头像 插槽 ​

名称说明
default自定义头像内容

头像组 API ​

头像组 属性 ​

名称说明类型默认值
size组内头像尺寸number / enum—
shape组内头像形状enum—
collapse-avatars是否折叠多余头像booleanfalse
collapse-avatars-tooltip鼠标悬停折叠文案时是否展示全部头像;需开启 collapse-avatarsbooleanfalse
max-collapse-avatars最多直接展示的头像数量;需开启 collapse-avatarsnumber1
effect文字提示主题,内置 dark / lightenum / stringlight
placement文字提示位置enumtop
popper-class文字提示的自定义类名string''
popper-style文字提示的自定义样式string / object—
collapse-class折叠占位头像的自定义类名string''
collapse-style折叠占位头像的自定义样式string / object—