# Avatar

Аватар із ініціалами, градієнтом бренду й падінням на ініціали, якщо картинка не завантажилась.


Замість чотирьох окремих реалізацій під ролі (USER/ASSISTANT/SYSTEM) —
один компонент: картинка → ініціали → порожнє коло. Рольові іконки — це
слот `default` споживача, а не зашитий Font Awesome.

## Приклад


Example (app/demos/avatar/AvatarBasic.vue):

```vue
<script setup lang="ts">
import UiAvatar from '~/components/ui/UiAvatar.vue'
</script>

<template>
  <div class="flex flex-wrap items-center gap-3">
    <UiAvatar name="Ігор Шевченко" :size="24" />
    <UiAvatar name="Марія Ковалишин" :size="32" />
    <UiAvatar name="Олег Марченко" :size="48" />
    <!-- Битий URL навмисно: демонструє падіння на ініціали -->
    <UiAvatar src="https://example.invalid/no-photo.png" name="Немає фото" :size="32" />
    <UiAvatar tone="neutral" name="Сервісний акаунт" :size="32" />
    <UiAvatar name="Оксана Литвин" :size="40" status="online" />
    <UiAvatar name="Денис Кравець" :size="40" status="busy" tone="neutral" />
    <!-- Кольорова палітра: колір стабільний для одного seed -->
    <UiAvatar v-for="(person, i) in ['Ігор Шевченко', 'Марія Ковалишин', 'Олег Марченко', 'Оксана Литвин', 'Денис Кравець', 'Софія Бондар']" :key="person" tone="auto" :seed="`demo-${i}`" :name="person" :size="40" />
    <!-- Обраний колір: color-index має пріоритет над seed. -->
    <UiAvatar tone="auto" seed="demo-0" :color-index="4" name="Команда продажів" :size="40" shape="square" />
    <!-- Компанія — квадрат; ініціали беруться з букв, а не з лапок: «ТС». -->
    <UiAvatar name="ТОВ «Сігма Трейд»" :size="40" shape="square" />
  </div>
</template>
```


## API

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

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

Будь-яке представлення людини чи акаунта: список користувачів, шапка
коментаря, вибір виконавця.

Компанія, команда чи сервіс — `shape="square"`: коло підказує «людина», а
логотип у колі ще й втрачає кути.

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

Для логотипів компаній із складною геометрією краще слот `default` з
власним SVG, ніж спроби вмістити логотип в ініціали.

## Ініціали

Беруться перші БУКВИ чи цифри двох перших слів, а не перші символи: назви
компаній починаються з лапок і дужок, і «ТОВ «Сігма Трейд»» давало «Т«».
Слово без жодної букви («—», «&») пропускається.

Кегль — частка діаметра (40% для однієї літери, 36% для пари: «МШ» чи «ЖД» при
40% впиралися в краї кола), а не сходинки `text-xs`/`text-sm`: сходинки
впиралися в 13px на будь-якому розмірі, а плитка «+N» в
[`UiAvatarGroup`](https://ui.tatet.net/docs/components/avatar-group) росла пропорційно, і на
64px «+3» був удвічі більшим за ініціали поруч. Тепер формула одна на обох.

Заливка — градієнт `primary-600 → primary-700`: на попередньому
`400 → 600` білі ініціали мали 2.5:1 у світлому куті, нижче 4.5:1 для
тексту такого кегля.

## Кольорова палітра

`tone="auto"` фарбує аватар одним із восьми кольорів (синій, фіолетовий,
рожевий, теракотовий, зелений, смарагдовий, бірюзовий, червоний), які
обираються за `seed` — або за `name`, якщо `seed` не заданий. Так у списку
чатів і в групі відправників видно одразу, не читаючи імен. Передавайте
**стабільний ідентифікатор** (id), а не ім'я: інакше перейменування змінює
колір людини. Кожен колір — градієнт зі змінних `--avatar-N-from/to`
(`assets/css/tokens.css`), однаковий у світлій і темній темах, з білим
текстом не нижче 4.5:1 у найсвітлішій точці. Без `tone="auto"` аватар
лишається синім, як раніше.

Коли колір обирає людина (простір, команда, тег), передайте його номер у
`color-index` (0…7, той самий порядок, що й `--avatar-N`): він має пріоритет
над `seed`. Поза межами палітри чи `undefined` — колір за `seed`, тож
сутності без вибору виглядають як раніше. Номер для власних позначок того
самого кольору (смужка, крапка) дає `avatarPaletteIndex(seed)` з цього ж
файлу.

## Кільце індикатора

Крапка статусу обведена кільцем кольору картки — так вона «вирізана» з
аватара. Коли аватар стоїть на іншому тлі (активний рядок списку, hover),
задайте предку CSS-змінну `--avatar-ring` — кільце підхопить її і не
світитиметься плямою: `class="hover:[--avatar-ring:var(--bg-hover)]"`.

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

Контейнер має `role="img"` і `aria-label` з імені; картка всередині —
з порожнім `alt`, щоб скрінрідер не читав «av2871.jpg» двічі. Битий
URL ніколи не лишає «скелець» — компонент сам перемикається на ініціали.

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