# HoverCard

Немодальний preview із delay, hover-focus parity та SSR-безпечним Teleport.


## Приклад


Example (app/demos/hover-card/HoverCardBasic.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'

const open = shallowRef(false)
</script>

<template>
  <p class="text-sm text-muted">
    Автор бібліотеки —
    <UiHoverCard v-model="open" aria-label="Профіль автора">
      <template #trigger="{ triggerAttrs }">
        <a v-bind="triggerAttrs" href="#profile" class="font-medium text-accent underline decoration-dotted underline-offset-4 focus:outline-none focus-visible:ring-2 focus-visible:ring-ring">Ігор</a>
      </template>
      <div class="flex gap-3">
        <UiAvatar name="Ігор К." :size="48" />
        <div>
          <p class="font-semibold text-ink">Ігор К.</p>
          <p class="mt-1 text-sm text-muted">Vue-розробник і автор tatetUI.</p>
          <a href="#follow" class="mt-3 inline-block text-sm font-medium text-accent">Підписатися</a>
        </div>
      </div>
    </UiHoverCard>.
  </p>
</template>

```


## API

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

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

Для необовʼязкового preview профілю, посилання, терміна чи сутності без
переходу на окрему сторінку. Вміст має доповнювати, а не бути необхідним для
розуміння trigger.

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

Не використовуйте для кнопок дій, обовʼязкової підказки або мобільного-only
сценарію. Для короткої назви є `UiTooltip`, для інтерактивних налаштувань —
`UiPopover`.

На дотику картка не відкривається взагалі. Наведення там немає, а сумісні
`mouseenter` і фокус, які браузер шле після тапу по посиланню, відкривали
картку поверх переходу — вона блимала перед новою сторінкою. Тригер
лишається звичайним посиланням.

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

Focus відкриває той самий вміст, що й hover. Невелика затримка закриття
дозволяє перевести курсор у телепортовану картку.

Картка стоїть у кінці `body`, тож Tab із тригера, поки вона відкрита, веде в
неї — на перше посилання чи кнопку. Tab з останнього веде до елемента за
тригером на сторінці, Shift+Tab із першого — назад на тригер. Сам фокус у
картку не стрибає, інакше прохід Tab'ом по списку посилань застрягав би в
кожній.

Escape і клік поза карткою закривають її. Курсор, що пройшов тригером
швидше за `openDelay`, картку не відкриває: раніше вона з'являлася вже після
того, як курсор пішов, і лишалася висіти.



## Event descriptions

- `update:modelValue`: Картку показано або приховано.
- `open`: Картка відкрилася після delay.
- `close`: Картка закрилася.


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