# Expand

Один розкривний блок для зауважень, деталей і додаткових налаштувань.


Expand залишає видимим короткий заголовок, а довгі пояснення розкриває
натисканням. Типово блок згорнутий. Лічильник у слоті `trailing` і тон
`warning` допомагають помітити зауваження ще до відкриття.

## Приклад


Example (app/demos/expand/ExpandBasic.vue):

```vue
<script setup lang="ts">
import UiExpand from '~/components/ui/UiExpand.vue'

const issues = [
  'Уточніть матеріал товарів у правилах добірки.',
  'Перед схваленням перевірте схожі сторінки.',
  'Додайте опис секції українською та російською мовами.',
]
</script>

<template>
  <UiExpand title="Зауваження до пропозиції" size="sm" tone="warning">
    <template #trailing>
      <span class="rounded-control bg-card px-1.5 py-0.5 text-xs tabular-nums">{{ issues.length }}</span>
    </template>
    <ul class="space-y-2">
      <li v-for="issue in issues" :key="issue" class="rounded-control bg-warning-bg p-3 text-xs text-warning">
        {{ issue }}
      </li>
    </ul>
  </UiExpand>
</template>

```


## Керування станом

Без `v-model` компонент сам зберігає відкритий стан; `default-open`
розкриває його під час створення. З `v-model` стан визначає батьківський
компонент — можна розгорнути або згорнути блок зовнішньою кнопкою.


Example (app/demos/expand/ExpandControlled.vue):

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

const open = ref(true)
const note = ref('Перевірити правила добірки')
</script>

<template>
  <div class="space-y-3">
    <UiButton size="sm" variant="outline" @click="open = !open">
      {{ open ? 'Згорнути деталі' : 'Розгорнути деталі' }}
    </UiButton>
    <UiExpand v-model="open" title="Додаткові налаштування">
      <UiInput v-model="note" label="Нотатка" />
      <p class="mt-2 text-xs text-muted">Введений текст зберігається після згортання.</p>
    </UiExpand>
    <UiExpand title="Архівні налаштування" disabled>
      Цей блок наразі недоступний.
    </UiExpand>
  </div>
</template>

```


Вміст зберігається змонтованим, тому згортання не скидає введені дані.
Щоб починати зі згорнутого блоку при переході до іншого запису, задайте
`:key="record.id"` на `UiExpand`.

## API

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

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

- Довгий список зауважень із видимою кількістю повідомлень.
- Додаткові поля або деталі запису, які потрібні за запитом.
- Розкривне пояснення результату перевірки.

Для перенесення скопіюйте `app/components/ui/UiExpand.vue`, а також спільні
`tokens.css` і `theme.css` за [інструкцією](https://ui.tatet.net/docs/copy-guide).
Додаткових компонентів або пакетів Expand не потребує.

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

- Для групи пов'язаних розділів із навігацією між заголовками використовуйте
  [Accordion](https://ui.tatet.net/docs/components/accordion).
- Для помилки поточної дії, яку користувач має відразу прочитати.
- Для основної навігації або дій, приховання яких завадить роботі.

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

Заголовок — нативна кнопка з `aria-expanded` і `aria-controls`.
Enter і Space перемикають стан; Tab переводить фокус до наступного елемента.
Не вкладайте кнопки чи посилання у слоти заголовка — розміщуйте їх у вмісті.

Згорнута панель має `inert` та `aria-hidden`, тому її поля й посилання
не потрапляють у клавіатурну навігацію. Якщо зовнішній `v-model` згортає
панель із фокусом усередині, фокус повертається на заголовок.

Висота анімується через CSS Grid без JS-вимірювань; `prefers-reduced-motion`
вимикає анімацію. Кольори використовують токени й працюють в обох темах.


## Event descriptions

- `update:modelValue`: Запит на зміну відкритого стану. Використовуйте через `v-model`.


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