# Tooltip

Підказка навколо тригера — чотири позиції, затримка показу, показ по фокусу.


Заміна атрибута `title` і саморобної директиви `v-tooltip` — та сама поведінка,
але з керуванням позицією, затримкою й доступністю. Своїй стороні бракує
місця — підказка перевертається на протилежний бік (по обох осях), і лише
коли не влазить і він, притискається до країв вікна.

## Приклад


Example (app/demos/tooltip/TooltipBasic.vue):

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

<template>
  <div class="flex flex-wrap items-center justify-center gap-3">
    <UiTooltip content="Видалити без можливості відновлення">
      <template #default="{ describedBy }">
        <UiButton variant="danger" size="icon" aria-label="Видалити" :aria-describedby="describedBy">
          <svg class="h-4 w-4" viewBox="0 0 24 24" fill="none" aria-hidden="true">
            <path d="M3 6h18M8 6V4h8v2m-9 0 1 14h8l1-14" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
          </svg>
        </UiButton>
      </template>
    </UiTooltip>

    <UiTooltip placement="bottom" content="Підказка знизу тригера">
      <template #default="{ describedBy }">
        <UiButton variant="outline" :aria-describedby="describedBy">Знизу</UiButton>
      </template>
    </UiTooltip>

    <UiTooltip placement="right" content="Підказка праворуч тригера">
      <template #default="{ describedBy }">
        <UiButton variant="ghost" :aria-describedby="describedBy">Праворуч</UiButton>
      </template>
    </UiTooltip>
  </div>
</template>
```


## API

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

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

Для пояснення ІКОНКИ або стислого скорочення. Текст підказки — доповнення,
яке можна пропустити.

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

Не ховайте в підказку то, що потрібно ОБОВ'ЯЗКОВО: на дотику її відкриває
лише довге натискання, про яке мало хто знає, а скрінрідер прочитає її
лише з `described-by`.

## На дотику

Тап підказку НЕ показує: раніше сумісний `mouseenter`, який браузер шле
після тапу, відкривав її через 200 мс після натискання — і вона висіла,
доки не торкнешся чогось іншого. Тепер, як на Android, підказку відкриває
довге натискання (0,5 с), а після відпускання вона ховається через 1,5 с.
Клік, що приходить слідом за довгим натисканням, гаситься: людина хотіла
прочитати, а не натиснути.

Для форм замість підказки в button title є prop `hint` в Input — підказка
в потоці надійніша.

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

Панель має `role="tooltip"` і `id`; слот тригера віддає `describedBy` —
прокиньте його в `aria-describedby` інтерактивного елемента.

Наведення показує підказку після `delay`, а фокус **із клавіатури** — одразу
й разом з `aria-describedby`. Із затримкою скрінрідер встигав оголосити
кнопку раніше, ніж з'являвся її опис. Фокус від кліку мишею підказку не
показує, а саме натискання її ховає.

Курсор можна перевести з тригера на саму підказку й дочитати її: вона
чекає `closeDelay`, поки курсор перетинає зазор (WCAG 1.4.13).

`Escape` ховає підказку й далі не йде. Відкрита в модалці, вона раніше
закривала тим самим натиском і модалку разом із формою.


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