# Tabs

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


Дві форми: `underline` для розділення вмісту на сторінці та `pills` для
перемикача вигляду. Успадковану реалізацію переписано на токени: іконки
там були рядками-класами Font Awesome, тут — слоти `tab-<id>`.

Проп `size` додає компактні вкладки (`sm`) для панелей інструментів і
вкладок усередині картки — на дотику зону 45×45 добудовує невидимий
`::after`, тож кнопки вкладок лишилися щільними навіть на телефоні.

## Приклад


Example (app/demos/tabs/TabsBasic.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiTabs from '~/components/ui/UiTabs.vue'

const last = ref('—')
</script>

<template>
  <div class="flex min-w-0 flex-col gap-6">
    <UiTabs
      aria-label="Вигляд"
      :tabs="[
        { id: 'overview', label: 'Огляд' },
        { id: 'settings', label: 'Налаштування' },
        { id: 'logs', label: 'Журнал' },
        { id: 'archived', label: 'Архів', disabled: true },
      ]"
      @change="last = $event"
    >
      <template #panel-overview><p class="text-sm text-muted">Загальні показники об'єкта.</p></template>
      <template #panel-settings><p class="text-sm text-muted">Форми налаштувань.</p></template>
      <template #panel-logs><p class="text-sm text-muted">Події та помилки.</p></template>
    </UiTabs>

    <UiTabs
      variant="pills"
      aria-label="Щільність"
      :tabs="[
        { id: 'compact', label: 'Стисло' },
        { id: 'cozy', label: 'Вільно' },
      ]"
    >
      <template #panel-compact><p class="text-sm text-muted">Щільний список.</p></template>
      <template #panel-cozy><p class="text-sm text-muted">Список із повітрям.</p></template>
    </UiTabs>

    <div class="rounded-card border border-line bg-card p-3">
      <UiTabs
        size="sm"
        aria-label="Секції картки"
        :tabs="[
          { id: 'meta', label: 'Мета' },
          { id: 'files', label: 'Файли' },
          { id: 'activity', label: 'Активність' },
        ]"
      >
        <template #panel-meta><p class="text-sm text-muted">Метадані запису.</p></template>
        <template #panel-files><p class="text-sm text-muted">Прикріплені файли.</p></template>
        <template #panel-activity><p class="text-sm text-muted">Історія змін.</p></template>
      </UiTabs>
    </div>

    <p class="text-xs text-muted">Остання зміна: {{ last }}</p>
  </div>
</template>
```


## Синхронізація з URL

Передайте `queryParam="tab"` — активна вкладка читається з `?tab=` і
пишеться туди через `router.replace`. Для вкладки за замовчуванням
параметр НЕ пишеться: URL залишається чистим. Кнопки «Назад/Вперед»
перемикають вкладки, як сторінки.

Усі шляхи зміни вкладки проходять через одне місце, тож стан не
розходиться:

- вкладка з URL доходить до `v-model` (`update:modelValue`), але не
  викликає `change` — це не дія користувача;
- «Назад/Вперед» дає і `update:modelValue`, і `change`;
- зміна `v-model` згори (кнопка «Далі», перехід до поля з помилкою) теж
  пише параметр у URL — перезавантаження не поверне стару вкладку.

Параметр читається **після монтування**, а не під час рендеру.
Прередерена сторінка не знає про `?tab=`, і читання до гідрації давало
розбіжність: стара вкладка лишалась з активними класами поруч із новою.
Роутер компонент бере з застосунку, а не імпортом `vue-router`: без
встановленого роутера `queryParam` просто нічого не синхронізує.

## Вертикальні вкладки

`orientation="vertical"` ставить список стовпчиком ліворуч від панелі —
для сторінок налаштувань із багатьма розділами. Індикатор ковзає по
вертикалі, клавіатура перемикає ↑/↓. На вузькому екрані поверніть
горизонтальні вкладки прив'язкою пропа.


Example (app/demos/tabs/TabsVertical.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiTabs from '~/components/ui/UiTabs.vue'

const section = ref('profile')
</script>

<template>
  <div class="w-full max-w-xl">
    <UiTabs
      v-model="section"
      orientation="vertical"
      aria-label="Розділи налаштувань"
      :tabs="[
        { id: 'profile', label: 'Профіль' },
        { id: 'security', label: 'Безпека' },
        { id: 'billing', label: 'Оплата' },
        { id: 'api', label: 'API-ключі', disabled: true },
      ]"
    >
      <template #panel-profile><p class="text-sm text-muted">Ім'я, фото й контактна пошта.</p></template>
      <template #panel-security><p class="text-sm text-muted">Пароль і двофакторна автентифікація.</p></template>
      <template #panel-billing><p class="text-sm text-muted">Тариф, рахунки й спосіб оплати.</p></template>
    </UiTabs>
  </div>
</template>

```


## API

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

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

Коли вміст не вміщується без втрати контексту: налаштування об'єкта,
вкладки «Огляд / Журнал», перемикач щільності списку.

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

Якщо панелі — кроки однієї форми, потрібен Stepper, а не вкладки: вкладки
нічого не говорять про порядок і прогрес.

Не ховайте за вкладками те, що користувач має порівнювати одночасно.

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

`role="tablist"` → `role="tab"` → `role="tabpanel"` з `aria-selected`,
`aria-controls` і `aria-labelledby`. Roving tabindex: в обході Tab — лише
активна вкладка, стрілки (←/→, у вертикальних — ↑/↓) перемикають і
одразу активують панель; деактивовані вкладки пропускаються, а не
зупиняють обхід. Список оголошує `aria-orientation`.

Панель має `tabindex="0"`: без жодного фокусованого елемента (лише текст)
вона інакше недосяжна з клавіатури — Tab з вкладки перестрибував би її.

Коли вкладки не вміщуються, список гортається вбік, і фокус — стрілками
чи Tab — сам докручує вкладку в поле зору цілою. Браузер докручує лише
вкладку, сховану повністю; частково видиму він лишав обрізаною разом із
кільцем фокуса. Клік і тап список не зсувають: вкладка не тікає з-під
пальця.

Ні кільце фокуса крайньої вкладки, ні невидима зона дотику кнопки (45×45)
не обрізаються контейнером прокрутки: він має внутрішні відступи під них
(на coarse-вказівнику — вищі), а від'ємний марджин лишає розкладку як була.
Індикатор стежить за розміром кожної кнопки, тож довантажений веб-шрифт чи
лічильник у слоті не лишають його під старою шириною.

Слот `tab-<id>` налаштовує **вміст** кнопки — наприклад, додає іконку або
лічильник. Саму кнопку, id, ролі та keyboard handlers завжди рендерить
`UiTabs`. Якщо старий слот повертав власний `<button>`, залиште тільки його
внутрішню розмітку.


## Event descriptions

- `update:modelValue`: Новий активний id — зокрема відновлений з URL чи виправлений замість вимкненої вкладки. Використовуйте через `v-model`.
- `change`: Користувач перемкнув вкладку — клік, клавіатура або «Назад/Вперед» у браузері. Відновлення з URL і зміна v-model згори його не викликають.


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