# ButtonGroup

Зчеплені кнопки однієї теми — форматування, масштаб, дії з файлом — зі спільними швами.


Обгортка, що знімає внутрішні кути й накладає сусідні межі в одну лінію.
Кнопки лишаються звичайними `UiButton` — переставити їх чи додати ще одну
можна без правки класів.


Example (app/demos/button-group/ButtonGroupBasic.vue):

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

const zoom = shallowRef(100)
const bold = shallowRef(true)
const italic = shallowRef(false)
</script>

<template>
  <div class="flex w-full max-w-lg flex-col items-start gap-6">
    <!-- Стан кнопки-перемикача — aria-pressed, а не лише колір заливки. -->
    <UiButtonGroup label="Форматування тексту">
      <UiButton :variant="bold ? 'soft' : 'outline'" size="icon" label="Жирний" :aria-pressed="bold" @click="bold = !bold">
        <span class="text-sm font-bold" aria-hidden="true">Ж</span>
      </UiButton>
      <UiButton :variant="italic ? 'soft' : 'outline'" size="icon" label="Курсив" :aria-pressed="italic" @click="italic = !italic">
        <span class="text-sm italic" aria-hidden="true">К</span>
      </UiButton>
      <UiButton variant="outline" size="icon" label="Посилання">
        <svg class="h-4 w-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true">
          <path d="M10 13a5 5 0 0 0 7.5.5l3-3a5 5 0 0 0-7-7l-1.5 1.5M14 11a5 5 0 0 0-7.5-.5l-3 3a5 5 0 0 0 7 7L12 19" />
        </svg>
      </UiButton>
    </UiButtonGroup>

    <UiButtonGroup label="Масштаб">
      <UiButton variant="outline" size="sm" label="Зменшити" :disabled="zoom <= 50" @click="zoom -= 25">−</UiButton>
      <UiButton variant="outline" size="sm" class="min-w-16 justify-center tabular-nums" @click="zoom = 100">{{ zoom }}%</UiButton>
      <UiButton variant="outline" size="sm" label="Збільшити" :disabled="zoom >= 200" @click="zoom += 25">+</UiButton>
    </UiButtonGroup>

    <!-- Block-група ділить ширину порівну, а підпис кнопки не переноситься:
         три слова влазять і в 320px екран, довші підписи — ні. -->
    <UiButtonGroup label="Дії з файлом" block>
      <UiButton variant="outline">Друк</UiButton>
      <UiButton variant="outline">Експорт</UiButton>
      <UiButton variant="outline">Поділитися</UiButton>
    </UiButtonGroup>
  </div>
</template>

```


## API

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

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

- Панель інструментів із кількох пов'язаних дій: форматування, масштаб,
  вирівнювання.
- Кілька рівноцінних дій над одним об'єктом, які мають читатися разом.

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

- Для вибору ОДНОГО значення з кількох — це `UiToggleGroup`: у нього роль
  `radiogroup` і стрілки, а тут кожна кнопка — окрема дія.
- Для головної дії з варіантами — `UiSplitButton`, де стрілка відкриває
  меню.
- Для меню чи поповерів усередині групи: шви знімаються з ПРЯМИХ дітей, і
  обгортка навколо кнопки розірвала б групу.
- Для трьох-чотирьох довгих підписів на телефоні. Зчеплені кнопки не
  переносяться, а підпис кнопки — теж: `block`-група з трьома короткими
  словами влазить у 320px, «Перейменувати» поруч із двома сусідами — ні.
  На вузькому екрані — `orientation="vertical"`, іконки з `label` або
  менше кнопок.

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

`role="group"` з назвою з `label`: скрінрідер оголошує «Форматування
тексту, група» при вході в першу кнопку, і сусідство кнопок отримує сенс.
Не `toolbar`: ця роль зобов'язує до стрілок і однієї зупинки Tab, а тут
кожна кнопка — звичайна зупинка Tab.

Кнопки-перемикачі в групі (Жирний, Курсив) передають стан через
`aria-pressed`, а не лише кольором заливки. Кнопка на наведенні й у фокусі
піднімається над сусідами — інакше межа наведення й кільце фокуса з одного
боку ховалися б під сусідньою кнопкою.


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