Avatar 头像

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

基础用法

通过 shapesize 设置形状与尺寸。支持四种尺寸: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