# NavigationMenu

Продуктова навігація з dropdown-групами, посиланнями та клавіатурним focus management.


## Приклад


Example (app/demos/navigation-menu/NavigationMenuBasic.vue):

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

const openItem = shallowRef<string | null>(null)
const selected = shallowRef('Огляд')
const items = [
  { id: 'overview', label: 'Огляд', href: '#overview', current: true },
  {
    id: 'products',
    label: 'Продукти',
    children: [
      { id: 'analytics', label: 'Аналітика', description: 'Звіти й продуктові метрики', href: '#analytics' },
      { id: 'automation', label: 'Автоматизація', description: 'Тригери, дії та сценарії', href: '#automation' },
      { id: 'labs', label: 'Labs', description: 'Експериментальні можливості', disabled: true },
    ],
  },
  { id: 'pricing', label: 'Ціни', href: '#pricing' },
]
</script>

<template>
  <UiNavigationMenu v-model="openItem" :items="items" @select="selected = $event.label" />
  <p class="mt-6 text-sm text-muted">Останній вибір: {{ selected }}</p>
</template>

```


## Посилання і стан

Пункт без `children` — посилання. `to` рендериться через `NuxtLink` (з
`#components`, як в `UiButton`) і переходить без перезавантаження
сторінки; `href` — звичайний `<a>` для зовнішніх адрес і якорів. Подія
`select` приходить для обох.

`v-model` не обов'язковий: без нього меню саме пам'ятає, яка група
відкрита. `current` на дочірньому пункті ставить `aria-current="page"`, а
його група отримує `aria-current="true"` і той самий акцентний стан, що й
поточна сторінка.

## Розмір і вигляд

Пропси `size` і `variant` керують пропорціями та виглядом кореневих
пунктів, шеврона і панелі разом. Стан «поточної сторінки» малюється з
`current` пункту: `underline` підкреслює його, `pill` дає брендову
підкладку, `plain` змінює колір на акцентний.


Example (app/demos/navigation-menu/NavigationMenuCustomize.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'
import UiNavigationMenu, { type NavigationMenuItem } from '~/components/ui/UiNavigationMenu.vue'
import UiRadioGroup from '~/components/ui/UiRadioGroup.vue'

const openItem = shallowRef<string | null>(null)
const size = shallowRef<'sm' | 'md' | 'lg'>('md')
const variant = shallowRef<'plain' | 'underline' | 'pill'>('plain')
const selected = shallowRef('Огляд')

const items: NavigationMenuItem[] = [
  { id: 'overview', label: 'Огляд', href: '#overview', current: true },
  {
    id: 'products',
    label: 'Продукти',
    children: [
      { id: 'analytics', label: 'Аналітика', description: 'Звіти й продуктові метрики', href: '#analytics' },
      { id: 'automation', label: 'Автоматизація', description: 'Тригери, дії та сценарії', href: '#automation' },
      { id: 'labs', label: 'Labs', description: 'Експериментальні можливості', disabled: true },
    ],
  },
  { id: 'pricing', label: 'Ціни', href: '#pricing' },
]
</script>

<template>
  <div class="flex flex-col items-start gap-6">
    <div class="flex flex-wrap gap-6">
      <UiRadioGroup
        v-model="size"
        name="navigation-menu-size"
        orientation="horizontal"
        :options="[
          { value: 'sm', label: 'sm' },
          { value: 'md', label: 'md' },
          { value: 'lg', label: 'lg' },
        ]"
      />
      <UiRadioGroup
        v-model="variant"
        name="navigation-menu-variant"
        orientation="horizontal"
        :options="[
          { value: 'plain', label: 'plain' },
          { value: 'underline', label: 'underline' },
          { value: 'pill', label: 'pill' },
        ]"
      />
    </div>

    <div class="w-full rounded-card border border-line bg-card px-4 py-3">
      <UiNavigationMenu
        v-model="openItem"
        :size="size"
        :variant="variant"
        :items="items"
        @select="selected = $event.label"
      />
    </div>

    <p class="text-sm text-muted">
      size: <span class="font-medium text-ink">{{ size }}</span> ·
      variant: <span class="font-medium text-ink">{{ variant }}</span> ·
      Останній вибір: {{ selected }}
    </p>
  </div>
</template>
```


## API

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

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

Для головної навігації продукту, де кілька верхніх пунктів розкривають
невеликі групи повʼязаних сторінок. Прості пункти лишаються справжніми
посиланнями, групи — кнопками.

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

Не використовуйте як меню дій або великий багаторівневий sitemap. Для команд
є `UiMenu`, а глибоку структуру краще показати через `UiSidebar`.

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

Це disclosure-навігація, а не menubar: група — кнопка з `aria-expanded` і
`aria-controls`, пункти — справжні посилання в списку. Ролі
`menubar`/`menuitem`, що стояли тут раніше, обіцяли скрінрідеру контракт
меню, якого компонент не виконував, і ховали семантику посилань.

Tab проходить кожен доступний кореневий пункт. З відкритої групи Tab веде
в її панель, Shift+Tab з першого пункту панелі — назад на тригер, а Tab з
останнього закриває панель і продовжує рух від тригера: панель
телепортована в кінець `<body>`, і без цього фокус падав за кінець
документа. Фокус, що пішов за межі меню й панелі, закриває панель.

ArrowLeft і ArrowRight переміщують фокус між кореневими пунктами, ArrowDown
відкриває групу, Home та End переходять до країв. У панелі працюють
ArrowUp, ArrowDown і Escape. Disabled-посилання не потрапляють у обхід.

На дотику кореневі пункти добудовує до 45px невидима зона, а рядки
панелі на телефоні — 45px заввишки.

Шеврон групи — SVG, а не текстовий знак: символ «⌄» шрифти малюють
по-своєму, дрібно й зі з'їздом від базової лінії, тож вигляд залежав би
від системного шрифту. SVG масштабується пропорційно `size` і фарбується
через `currentColor`.


## Event descriptions

- `update:modelValue`: Ідентифікатор відкритої групи або null. Без v-model меню тримає цей стан саме.
- `select`: Обраний кореневий або дочірній пункт.


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