# ToggleGroup

Сегментний перемикач — вибір одного значення з двох-чотирьох видимих одразу.


Сегментний перемикач — «згорнуті радіокнопки»: усі варіанти видимі
одразу, без кліку на відкриття. Вигляд успадковано від `pills`-варіанту
Tabs, але семантика інша — це radiogroup без панелей вмісту.

## Приклад


Example (app/demos/toggle-group/ToggleGroupBasic.vue):

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

const view = ref<string | number>('list')
</script>

<template>
  <div class="flex max-w-sm flex-col gap-2">
    <UiToggleGroup
      v-model="view"
      aria-label="Вигляд списку"
      :options="[
        { value: 'list', label: 'Список' },
        { value: 'grid', label: 'Плитка' },
        { value: 'table', label: 'Таблиця' },
      ]"
      block
    />
    <p class="text-xs text-muted">Вигляд: {{ view }}</p>
  </div>
</template>
```


## API

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

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

Для 2–4 взаємовиключних варіантів, де користувач перемикається часто:
вигляд списку, одиниця виміру, період (день/тиждень/місяць).

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

Для перемикання ВМІСТУ — це робота Tabs: тут немає панелей і стану
«відкрито».

Для двох станів увімкнено/вимкнено потрібен Switch — сегментний
перемикач для «так/ні» виглядає як зайве рішення.

Більше 4–5 варіантів — Select: сегменти перестають вміщатись.

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

`role="radiogroup"` з `role="radio"` і `aria-checked`. Деактивовані
сегменти лишаються в DOM із `disabled`, щоб не «стрибає» ширина.

## Event descriptions

- `update:modelValue`: Активне значення. Використовуйте через `v-model`.
- `change`: Обрано інший сегмент.


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