---
url: /components/avatar-group.md
---
# AvatarGroup 头像组

`EvAvatarGroup` 将多个头像层叠排布，用于团队成员、协作者与参与用户等群体展示。
超过 `max` 数量时自动折叠为 `+N` 计数；层叠缝隙带页面底色描边，明暗主题下都干净。

## 基础用法

```vue
<EvAvatarGroup :items="team" :max="3" />
<EvAvatarGroup :items="[{ icon: 'github' }, { icon: 'vue' }]" />
```

## 搭配文字

```vue
<EvAvatarGroup :items="users" :max="4" />
<span>已有 12,800+ 位创作者加入</span>
```

## API

### Props

| 属性 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| items | 头像项 `[{ src?, name?, icon?, alt? }]`，字段同 EvAvatar | array | `[]` |
| max | 直接展示上限，溢出折叠为 +N（0 表示全部展示） | number | `0` |

### 插槽

| 插槽 | 说明 |
| --- | --- |
| default | 追加自定义头像（置于折叠计数之前） |