# Tree

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


Рендер плоский: дерево розгортається у список видимих рядків (вузол,
глибина, стан), тож у шаблоні один `v-for` без рекурсивних компонентів.
ARIA-геометрія тримається атрибутами `aria-level`, `aria-expanded`.

## Приклад


Example (app/demos/tree/TreeBasic.vue):

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

const items: TreeNode[] = [
  {
    id: 'example',
    label: 'example.com',
    children: [
      { id: 'home', label: 'Головна' },
      { id: 'about', label: 'Про нас' },
      {
        id: 'blog',
        label: 'Блог',
        children: [
          { id: 'post-1', label: 'Перший пост' },
          { id: 'post-2', label: 'Другий пост' },
        ],
      },
    ],
  },
  {
    id: 'shop',
    label: 'shop.example.com',
    children: [
      { id: 'catalog', label: 'Каталог' },
      { id: 'cart', label: 'Кошик' },
    ],
  },
  { id: 'trash', label: 'Кошик (порожній)', disabled: true },
]

const selected = ref<string | null>('home')
const expanded = ref<string[]>(['example'])
const lastClick = ref('—')
</script>

<template>
  <div class="max-w-sm">
    <UiTree
      v-model="selected"
      v-model:expanded="expanded"
      :items="items"
      @item-click="lastClick = $event.node.label"
    />
    <p class="mt-2 text-xs text-muted">
      Вибрано: {{ selected || '—' }} · відкриті: {{ expanded.join(', ') || '—' }} · клік: {{ lastClick }}
    </p>
  </div>
</template>
```


## API

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

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

Ієрархічні структури: дерево сторінок сайту, файлів, категорій.
Розгортання керується згори через `v-model:expanded` — можна відкривати
гілки з URL або синхронізувати дві панелі.

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

Для плоских списків із заголовками — Tree надлишковий, потрібен простий
список або Menu.

Для маленьких вкладених фільтрів (2 рівні, 5 пунктів) — чекбокси з
відступами простіші за дерево.

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

`role="tree"` → `treeitem` з `aria-level`, `aria-expanded`,
`aria-selected`. Roving tabindex: Tab — лише активний рядок, ↑↓ рухають
виділення, → розгортає, ← згортає або підіймається до батька.
Тоггл-кнопка окрема від рядка: розгортання не провокує вибір.

Tab завжди має куди потрапити. Якщо вибраний вузол сховано в згорнутій
гілці (`v-model` вказує на дитину, або гілку згорнули ззовні), точкою входу
стає його найближчий видимий предок, інакше — перший рядок. Раніше тоді
жоден рядок не мав `tabindex="0"`, і дерево з клавіатури було недосяжне.
Зміна `v-model` ззовні переносить точку входу на новий вибір.

Шеврон на дотику має невидиму зону 45px завширшки на всю висоту рядка: з
`expandOnClick: false` він єдиний спосіб розгорнути гілку пальцем. Вище за
рядок зона не росте — інакше зони сусідніх шевронів перекривались би.

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

Відступ — `padding-left: depth * 1.25rem` через `:style`, а не класи:
глибина довільна, JIT не може її передбачити.

## Event descriptions

- `update:modelValue`: Вибраний вузол або `null`. Використовуйте через `v-model`.
- `update:expanded`: Набір відкритих вузлів. Використовуйте через `v-model:expanded`.
- `itemClick`: Активація рядка кліком або Enter.


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