# Sidebar

Адаптивна бічна навігація з desktop collapse та mobile focus trap.


## Приклад


Example (app/demos/sidebar/SidebarBasic.vue):

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

const mobileOpen = shallowRef(false)
const collapsed = shallowRef(false)
const active = shallowRef('overview')
const side = shallowRef<'left' | 'right'>('left')
const links = [
  { id: 'overview', label: 'Огляд' },
  { id: 'projects', label: 'Проєкти' },
  { id: 'team', label: 'Команда' },
]
</script>

<template>
  <div class="relative flex min-h-72 overflow-hidden rounded-overlay border border-line">
    <UiSidebar
      v-model="mobileOpen"
      v-model:collapsed="collapsed"
      storage-key="tatetui-demo-sidebar"
      :side="side"
      width="14rem"
      collapsed-width="4rem"
    >
      <template #header="{ collapsed: isCollapsed }">
        <span class="font-semibold">{{ isCollapsed ? 'T' : 'tatetUI' }}</span>
      </template>
      <template #default="{ collapsed: isCollapsed, close }">
        <nav aria-label="Навігація демо" class="grid gap-1">
          <button
            v-for="link in links"
            :key="link.id"
            type="button"
            class="flex min-h-10 items-center gap-2.5 rounded-control px-3 text-left text-base md:text-sm"
            :class="active === link.id ? 'bg-primary-50 font-medium text-accent' : 'text-ink hover:bg-hover'"
            :aria-current="active === link.id ? 'page' : undefined"
            @click="active = link.id; close()"
          >
            <svg class="h-4.5 w-4.5 shrink-0" viewBox="0 0 24 24" fill="none" aria-hidden="true">
              <path d="M4 6h16M4 12h16M4 18h10" stroke="currentColor" stroke-width="2" stroke-linecap="round" />
            </svg>
            <span class="truncate">{{ isCollapsed ? link.id.charAt(0) : link.label }}</span>
          </button>
        </nav>
      </template>
      <template #footer="{ collapsed: isCollapsed }">
        <span class="text-xs text-muted">{{ isCollapsed ? 'IK' : 'Ігор К.' }}</span>
      </template>
    </UiSidebar>
    <main class="min-w-0 flex-1 p-6">
      <UiButton class="md:hidden" size="sm" @click="mobileOpen = true">Відкрити меню</UiButton>
      <div class="mt-3">
        <UiButton size="sm" variant="outline" @click="side = side === 'left' ? 'right' : 'left'">
          Панель: {{ side === 'left' ? 'ліворуч' : 'праворуч' }}
        </UiButton>
      </div>
    </main>
  </div>
</template>
```


## API

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

## Персистентність стану згортання

Передайте `storage-key`, і стан `collapsed` житиме між сесіями — той самий
принцип, що й у `UiResizablePanels`. Значення читається при монтуванні
(щоб не розійшлися server і client рендери) і записується при кожній зміні
`collapsed` — не лише з вбудованої кнопки, а й з коду застосунку (гаряча
клавіша, кнопка в шапці). Тому прив'язуйте до `v-model:collapsed` вибір
користувача, а не автоматичне згортання за шириною екрана — інакше
збережеться й воно. Сховище недоступне (private mode) — персистентність
мовчки вимикається, стан працює в межах сторінки.

Відновлений зі сховища стан застосовується без анімації ширини: інакше
серверна розгорнута панель на кожному завантаженні на очах з'їжджала б у
згорнуту, штовхаючи контент.

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

Для постійної навігації dashboard, admin або складного продукту. На desktop
панель бере участь у layout і може згортатися; на mobile відкривається поверх
контенту.

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

Не використовуйте для тимчасової форми або деталей сутності — це сценарій
`UiDrawer`. На простому сайті з трьома посиланнями достатньо звичайного `nav`.

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

На mobile панель отримує роль dialog, блокує прокрутку фону, утримує фокус і
закривається через Escape незалежно від того, де зараз фокус. Фокус при
відкритті отримує кнопка закриття (або елемент з `initial-focus`) — не сам
контейнер, тож Tab починається з реальної дії, а не з панелі. На desktop
залишається звичайним `aside` landmark. Кнопка collapse оголошує поточний
стан через `aria-expanded`, а її шеврон вказує в бік, куди панель згорнеться.

## Деталі реалізації

Компонент бере шар зі спільного стеку оверлеїв, тож `UiModal`, відкритий із
сайдбару, завжди поверх. `prefers-reduced-motion` вимикає анімацію панелі й
блюр фону. Тривалості — токени `--duration-*`: панель їде за
`--duration-slow` з `--ease-emphasized`, а Transition затемнення виводить
тривалість сам із його CSS, без числа, що розходилося б із токенами. Невидима зона дотику кнопок шапки — 45×45 через
`pointer-coarse:after:`. Логіка сховища живе в `app/utils/uiSidebar.ts` —
тестується без рендеру.

## Event descriptions

- `update:modelValue`: Мобільну панель відкрито або закрито.
- `update:collapsed`: Desktop-панель згорнуто або розгорнуто — змінено користувачем або прочитано зі сховища.
- `close`: Мобільну панель закрито.


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