Avatar 头像
Avatar 组件可以用来代表人物或对象,支持使用图片、图标或者文字作为 Avatar。默认圆形,背景为主题色浅底,文字与图标使用主题色。
ts
import { createApp } from 'vue'
import { ElAvatar, ElAvatarGroup } from '@szhn/dh-design-pc'
const app = createApp()
app.use(ElAvatar)
app.use(ElAvatarGroup)基础用法
使用 size 设置头像大小。设计尺寸为 24 / 32 / 40 / 48 / 56 / 64,也可使用 small(24)、默认(40)、large(56)。
展示类型
支持使用图片、图标或者文字作为 Avatar。
回退行为
图片加载失败时的回退行为。
适应容器
当使用图片作为用户头像时,设置该图片如何在容器中展示。与 object-fit 属性一致
头像组
使用 AvatarGroup 将多个头像叠加展示;开启 collapse-avatars 后超出数量会折叠为 +N。
Avatar API
Avatar 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| icon | 设置 Avatar 的图标类型,具体参考 Icon 组件 | string / Component | — |
| size | Avatar 大小 | number / enum | — |
| shape | Avatar 形状 | enum | — |
| src | Avatar 图片的源地址 | string | — |
| src-set | 图片 Avatar 的原生 srcset 属性 | string | string |
| alt | 图片 Avatar 的原生 alt 属性 | string | — |
| fit | 当展示类型为图片的时候,设置图片如何适应容器 | enum | cover |
Avatar 事件
| 名称 | 说明 | 类型 |
|---|---|---|
| error | 图片加载失败时触发 | Function |
Avatar 插槽
| 插槽名 | 说明 |
|---|---|
| default | 自定义头像展示内容 |
AvatarGroup API
AvatarGroup Attributes
| 方法名 | 详情 | Type | 默认 |
|---|---|---|---|
| size | 控制头像组中的头像大小 | number / enum | — |
| shape | 控制头像组中的头像形状 | enum | — |
| collapse-avatars | 是否折叠头像 | boolean | false |
| collapse-avatars-tooltip | 是否在鼠标悬停折叠头像的文字时显示所有折叠头像。 若要使用此功能, collapse-avatars 必须为 true | boolean | false |
| max-collapse-avatars | 需要显示的头像的最大数量 若要使用此功能, collapse-avatars 必须为 true | number | 1 |
| effect | tooltip 主题,内置了 dark / light 两种 | enum / string | light |
| placement | tooltip 的位置 | enum | top |
| popper-class | tooltip 的自定义类名 | string | '' |
| popper-style | tooltip 的自定义样式 | string / object | — |
| collapse-class | collapse-avatar 的自定义类名 | string | '' |
| collapse-style | collapse-avatar 的自定义样式 | string / object | — |
