# AvatarGroup

Стек аватарів із переповненням «+N», де приховані учасники лишаються названими.


Учасники угоди, відповідальні за задачу, підписники на розсилку — скрізь,
де людей кілька, а місця на рядок мало.


Example (app/demos/avatar-group/AvatarGroupBasic.vue):

```vue
<script setup lang="ts">
import UiAvatarGroup, { type AvatarGroupItem } from '~/components/ui/UiAvatarGroup.vue'

const team: AvatarGroupItem[] = [
  { id: 1, name: 'Олена Ковальчук' },
  { id: 2, name: 'Андрій Мельник' },
  { id: 3, name: 'Ірина Бондар' },
  { id: 4, name: 'Тарас Шевчук' },
  { id: 5, name: 'Марія Лисенко' },
  { id: 6, name: 'Дмитро Гнатюк' },
  { id: 7, name: 'Софія Кравець' },
]
</script>

<template>
  <div class="space-y-6">
    <div>
      <p class="mb-2 text-xs uppercase tracking-wide text-muted">Уся команда вміщається</p>
      <UiAvatarGroup :items="team.slice(0, 4)" label="Учасники угоди" />
    </div>

    <div>
      <p class="mb-2 text-xs uppercase tracking-wide text-muted">Переповнення: решта — у підписі «+N»</p>
      <UiAvatarGroup :items="team" :max="4" label="Учасники проєкту" />
    </div>

    <div>
      <p class="mb-2 text-xs uppercase tracking-wide text-muted">Щільніше накладання, більший розмір</p>
      <UiAvatarGroup :items="team" :max="5" :size="44" overlap="tight" label="Відповідальні" />
    </div>
  </div>
</template>

```


## Приховані не означає зниклі

Обрізати список до `max` — це рішення про ПЛОЩУ, а не про зміст. Для того,
хто дивиться очима, «+3» достатньо: наведе або клікне й побачить решту.
Для скрінрідера обрізаний аватар зникає безслідно.

Тому плитка «+N» несе `aria-label` з переліком решти імен, а не самим
числом. Три приховані учасники читаються як «Ще 3: Тарас Шевчук, Марія
Лисенко, Дмитро Гнатюк».

Альтернативу — один `role="img"` на всю групу з переліком усіх імен —
відкинуто: вона дає рядок на двісті символів і вбиває можливість зробити
кожен аватар окремим посиланням.

## Порядок накладання

Візуально стек має йти зліва направо з першим аватаром ЗВЕРХУ, але в DOM
пізніший сусід малюється поверх раннього. Тому `z-index` спадає разом з
індексом. Це локальний контекст накладання, зі спільним
[стеком оверлеїв](https://ui.tatet.net/docs/patterns/overlays) він не пов'язаний і в нього не
втручається.

Кільце навколо аватара — `box-shadow` кольором `--bg-card`, а не біла
рамка: на темній темі біла обвідка світилася б. З `shape="square"` кільце,
аватари й плитка «+N» стають квадратними разом — квадрат у круглому кільці
виглядав би обведеним чужим контуром.

Кегль «+N» — та сама формула, що в ініціалах `UiAvatar`, тож лічильник не
стоїть удвічі більшим за сусідів.

## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiAvatarGroup)

## Коли використовувати

- Учасники запису в CRM: угода, задача, тікет.
- Колонка «Відповідальні» в таблиці, де на рядок є два сантиметри.
- Підсумок «хто вже переглянув» під документом.

## Коли НЕ використовувати

- Коли імена важливіші за обличчя — тоді це список із іменами, а не стек.
- Для одного учасника: `UiAvatar` напряму, без обгортки.
- Як засіб вибору. Стек показує, а не редагує; для вибору людей є
  `UiMultiSelect`.

## Доступність

Група — `<ul>` з `aria-label`, кожен аватар у власному `<li>`. `UiAvatar`
всередині лишається `role="img"` з власним іменем, тож кожен учасник
читається окремо.

Наскрізна навігація не додається навмисно: стек аватарів не є набором
контролів. Якщо аватари мають бути посиланнями, обгорніть їх у слоті
`avatar` — і тоді фокус з'явиться природно.


[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/avatar-group.json)
