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
+ 4use collapse-class and collapse-style
+ 4use max-collapse-avatars


+ 2use collapse-avatars-tooltip


+ 2头像 API
头像 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| icon | 图标类型,详见图标组件 | string / Component | — |
| size | 尺寸 | number / enum | — |
| shape | 形状 | enum | — |
| src | 图片头像地址 | string | — |
| src-set | 图片原生 srcset | string | — |
| alt | 图片原生 alt | string | — |
| fit | 图片头像的适应方式 | enum | cover |
| bg-color | 自定义背景颜色 | string | — |
头像 事件
| 事件名 | 说明 | 类型 |
|---|---|---|
| error | 图片加载失败时 | Function |
头像 插槽
| 名称 | 说明 |
|---|---|
| default | 自定义头像内容 |
头像组 API
头像组 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| size | 组内头像尺寸 | number / enum | — |
| shape | 组内头像形状 | enum | — |
| collapse-avatars | 是否折叠多余头像 | boolean | false |
| collapse-avatars-tooltip | 鼠标悬停折叠文案时是否展示全部头像;需开启 collapse-avatars | boolean | false |
| max-collapse-avatars | 最多直接展示的头像数量;需开启 collapse-avatars | number | 1 |
| effect | 文字提示主题,内置 dark / light | enum / string | light |
| placement | 文字提示位置 | enum | top |
| popper-class | 文字提示的自定义类名 | string | '' |
| popper-style | 文字提示的自定义样式 | string / object | — |
| collapse-class | 折叠占位头像的自定义类名 | string | '' |
| collapse-style | 折叠占位头像的自定义样式 | string / object | — |