# ContextMenu

Меню дій у координатах pointer із підтримкою Shift+F10 та клавіші Context Menu.


## Приклад


Example (app/demos/context-menu/ContextMenuBasic.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'
import { menuItemClass } from '~/utils/uiFieldStyles'

const open = shallowRef(false)
const action = shallowRef('Ще не обрано')

function select(label: string, close: () => void) {
  action.value = label
  close()
}
</script>

<template>
  <UiContextMenu v-model="open" aria-label="Дії з файлом">
    <template #default="{ targetAttrs }">
      <button
        v-bind="targetAttrs"
        type="button"
        class="flex min-h-40 w-full items-center justify-center rounded-overlay border border-dashed border-line bg-subtle px-6 text-center text-sm text-muted focus:outline-none focus-visible:ring-2 focus-visible:ring-ring"
      >
        Натисніть правою кнопкою, утримайте пальцем або Shift+F10
      </button>
    </template>
    <template #content="{ close }">
      <button role="menuitem" :class="[menuItemClass, 'rounded-control text-ink']" @click="select('Перейменувати', close)">Перейменувати</button>
      <button role="menuitem" :class="[menuItemClass, 'rounded-control text-ink']" @click="select('Дублювати', close)">Дублювати</button>
      <button role="menuitem" :class="[menuItemClass, 'rounded-control text-danger']" @click="select('Видалити', close)">Видалити</button>
    </template>
  </UiContextMenu>
  <p class="mt-3 text-sm text-muted">Остання дія: {{ action }}</p>
</template>

```


## API

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

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

Для другорядних дій над файлом, вузлом дерева, рядком таблиці або полотном.
`targetAttrs` мають бути на реальному фокусованому target, щоб клавіатурний
виклик працював поруч із ним.

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

Не ховайте тут єдиний шлях до важливої дії. Context menu доповнює видимі
кнопки або `UiMenu`, а не замінює їх.

## Довгі списки: одне меню на список

Меню в кожному рядку — це екземпляр компонента, обробники й Teleport на
рядок. У переписці чи списку чатів на сотню рядків воно коштує більше, ніж
самі рядки. Для таких списків передайте `targetAttrs` **контейнеру**, а
рядки позначте селектором `targetSelector`: меню відкривається для
найближчого до події рядка, а сам рядок приходить у слот `content` як
`target` і в подію `open`. Права кнопка, Shift+F10 на сфокусованому рядку й
довге натискання працюють так само; подія повз рядки меню не відкриває й
системного меню не гасить.


Example (app/demos/context-menu/ContextMenuDelegated.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'
import { menuItemClass } from '~/utils/uiFieldStyles'

const open = shallowRef(false)
const action = shallowRef('Ще не обрано')
const files = ['Звіт за квартал.pdf', 'Макети v3.fig', 'Нотатки зустрічі.md', 'Бюджет 2026.xlsx', 'Логотип.svg']

function select(label: string, target: HTMLElement | null, close: () => void) {
  action.value = `${label}: ${target?.dataset.file ?? '—'}`
  close()
}
</script>

<template>
  <UiContextMenu v-model="open" aria-label="Дії з файлом" target-selector="[data-file]">
    <template #default="{ targetAttrs }">
      <ul v-bind="targetAttrs" class="w-full divide-y divide-line rounded-overlay border border-line bg-card">
        <li
          v-for="file in files"
          :key="file"
          :data-file="file"
          aria-haspopup="menu"
          tabindex="0"
          class="px-4 py-3 text-sm text-ink focus:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring"
        >
          {{ file }}
        </li>
      </ul>
    </template>
    <template #content="{ close, target }">
      <button role="menuitem" :class="[menuItemClass, 'rounded-control text-ink']" @click="select('Перейменувати', target, close)">Перейменувати</button>
      <button role="menuitem" :class="[menuItemClass, 'rounded-control text-ink']" @click="select('Завантажити', target, close)">Завантажити</button>
      <button role="menuitem" :class="[menuItemClass, 'rounded-control text-danger']" @click="select('Видалити', target, close)">Видалити</button>
    </template>
  </UiContextMenu>
  <p class="mt-3 text-sm text-muted">Остання дія: {{ action }}</p>
</template>

```


Контейнер aria-атрибутів меню не отримує — позначте рядки самі:
`aria-haspopup="menu"` і `tabindex="0"`, щоб Shift+F10 і повернення фокуса
після закриття працювали з клавіатури. Фокус після закриття повертається на
рядок, для якого меню відкрили.

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

Shift+F10 та клавіша Context Menu відкривають меню без миші. ArrowUp,
ArrowDown, Home і End переміщують фокус між доступними `menuitem`, друк
літери — на пункт, що з неї починається. Escape закриває й повертає фокус на
target, Tab закриває й веде до елемента після target.

## Дотик

Довге натискання пальцем чи пером (600 мс) відкриває меню в точці дотику.
iOS Safari на довге натискання **не шле** `contextmenu`, тож без власного
таймера меню на iPhone та iPad не відкривалося взагалі. Рух пальця далі за
10 px — це прокрутка, і таймер скасовується. Click, яким браузер може
догнати відпускання пальця, гаситься — інакше довге натискання спрацювало б
ще й як звичайне по першому пункту під пальцем.

`targetAttrs` додають target `-webkit-touch-callout: none`, щоб iOS не
показував поверх меню власну виноску «Копіювати/Поділитися».

`haptic` додає короткий тактильний відгук, коли меню відкрило саме довге
натискання, — як у нативних застосунках. Працює там, де є Vibration API
(Android); iOS Safari вібрації не має, і меню там відкривається мовчки.
Правий клік мишею й клавіатура відгуку не дають.


## Event descriptions

- `update:modelValue`: Меню відкрито або закрито.
- `open`: Меню відкрилося. Аргумент — елемент, для якого його відкрили (з `targetSelector` — рядок списку).
- `close`: Меню закрилося.


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