# ActionBar

Плаваюча панель дій над обраними записами або незбереженими змінами.


Панель з'являється, коли є над чим діяти: обрано записи в списку або форма
має незбережені зміни. Видимість — похідний стан, тому це не `v-model`, а
звичайний props `open`: закриває панель батько, прибравши причину.


Example (app/demos/action-bar/ActionBarSelection.vue):

```vue
<script setup lang="ts">
import { computed, ref } from 'vue'
import UiActionBar from '~/components/ui/UiActionBar.vue'
import UiButton from '~/components/ui/UiButton.vue'
import UiCheckbox from '~/components/ui/UiCheckbox.vue'
import { useToast } from '~/composables/useToast'

interface Photo {
  id: number
  name: string
  src: string
  size: string
}

const toast = useToast()

const photos = ref<Photo[]>([
  { id: 1, name: 'Ваза «Теракота»', src: '/demo/vase-terracotta.svg', size: '2,4 МБ' },
  { id: 2, name: 'Ваза «Кобальт»', src: '/demo/vase-cobalt.svg', size: '1,9 МБ' },
  { id: 3, name: 'Чашка «Вершки»', src: '/demo/mug-cream.svg', size: '1,1 МБ' },
  { id: 4, name: 'Миска «Шавлія»', src: '/demo/bowl-sage.svg', size: '1,6 МБ' },
  { id: 5, name: 'Тарілка «Ряба»', src: '/demo/plate-speckled.svg', size: '1,3 МБ' },
])

const selected = ref<number[]>([])
const allChecked = computed(() => selected.value.length === photos.value.length)

function toggle(id: number, value: boolean) {
  selected.value = value ? [...selected.value, id] : selected.value.filter((item) => item !== id)
}

function toggleAll(value: boolean) {
  selected.value = value ? photos.value.map((photo) => photo.id) : []
}

function remove() {
  const count = selected.value.length
  photos.value = photos.value.filter((photo) => !selected.value.includes(photo.id))
  selected.value = []
  toast.success(`Видалено фото: ${count}`)
}
</script>

<template>
  <div class="w-full">
    <div class="mb-3 flex items-center justify-between">
      <UiCheckbox
        :model-value="allChecked"
        :indeterminate="selected.length > 0 && !allChecked"
        label="Обрати всі"
        @update:model-value="toggleAll"
      />
      <span class="text-sm text-muted">{{ photos.length }} фото</span>
    </div>

    <ul class="grid grid-cols-2 gap-3 sm:grid-cols-3">
      <li
        v-for="photo in photos"
        :key="photo.id"
        class="overflow-hidden rounded-card border bg-card transition-colors"
        :class="selected.includes(photo.id) ? 'border-accent-solid ring-[3px] ring-ring/15' : 'border-line'"
      >
        <img :src="photo.src" :alt="photo.name" class="aspect-[4/3] w-full object-cover" />
        <div class="p-3">
          <UiCheckbox
            :model-value="selected.includes(photo.id)"
            :label="photo.name"
            :description="photo.size"
            @update:model-value="toggle(photo.id, $event)"
          />
        </div>
      </li>
    </ul>

    <!-- sticky: панель прилипає до низу екрана, поки видно список, і
         стоїть у потоці одразу після нього — Tab доходить до дій природно. -->
    <UiActionBar :open="selected.length > 0" :count="selected.length" label="фото обрано" @dismiss="selected = []">
      <UiButton variant="ghost" size="sm" @click="toast.info('Архів готується')">Завантажити</UiButton>
      <UiButton variant="danger" size="sm" @click="remove">Видалити</UiButton>
    </UiActionBar>
  </div>
</template>

```


## Незбережені зміни

Та сама панель без лічильника — рядок «Незбережені зміни» з діями
«Відкинути» і «Зберегти». Хрестик і Escape тут означають «відкинути»:
подія `dismiss` одна, а сенс їй дає батько.


Example (app/demos/action-bar/ActionBarUnsaved.vue):

```vue
<script setup lang="ts">
import { computed, reactive } from 'vue'
import UiActionBar from '~/components/ui/UiActionBar.vue'
import UiButton from '~/components/ui/UiButton.vue'
import UiInput from '~/components/ui/UiInput.vue'
import UiSwitch from '~/components/ui/UiSwitch.vue'
import { useToast } from '~/composables/useToast'

const toast = useToast()

const saved = reactive({ name: 'Керамічна майстерня', publicProfile: true })
const draft = reactive({ ...saved })

const dirty = computed(() => draft.name !== saved.name || draft.publicProfile !== saved.publicProfile)

function discard() {
  Object.assign(draft, saved)
}

function save() {
  Object.assign(saved, draft)
  toast.success('Налаштування збережено')
}
</script>

<template>
  <div class="w-full max-w-lg">
    <div class="space-y-4 rounded-card border border-line bg-card p-5">
      <UiInput v-model="draft.name" label="Назва магазину" />
      <div class="flex items-center justify-between gap-4">
        <div>
          <p class="text-sm font-medium text-ink">Публічний профіль</p>
          <p class="text-xs text-muted">Покупці бачать сторінку магазину в каталозі</p>
        </div>
        <UiSwitch v-model="draft.publicProfile" label="Публічний профіль" />
      </div>
    </div>

    <UiActionBar :open="dirty" label="Незбережені зміни" aria-label="Незбережені зміни" @dismiss="discard">
      <UiButton variant="ghost" size="sm" @click="discard">Відкинути</UiButton>
      <UiButton size="sm" @click="save">Зберегти</UiButton>
    </UiActionBar>
  </div>
</template>

```


## У вузькій панелі

Розкладку обирає ширина, яку панелі дали, а не ширина екрана: смуга
навколо неї — контейнер для запитів `@container`. Липка панель здебільшого
живе в дравері чи бічній колонці, набагато вужчій за вікно, і медіазапит
відповідав би там не на те питання.

- **Від 36rem (540px)** — один ряд. Лічильник не стискається, а дії, що не
  вмістилися, переносяться всередині своєї групи.
- **Вужче** — лічильник і хрестик угорі, дії окремим рядком на всю ширину
  під ними.
- **На телефоні** (екран вужчий за `md`) рядок дій не переноситься, а
  гортається вбік: п'ять кнопок займають один ряд, а не половину екрана.
  На ширшому екрані рядок переноситься — мишею смугу з прихованим
  скролбаром легко не помітити.


Example (app/demos/action-bar/ActionBarPanel.vue):

```vue
<script setup lang="ts">
import { computed, ref, useId } from 'vue'
import UiActionBar from '~/components/ui/UiActionBar.vue'
import UiButton from '~/components/ui/UiButton.vue'
import UiCheckbox from '~/components/ui/UiCheckbox.vue'
import { useToast } from '~/composables/useToast'

interface Order {
  id: number
  title: string
  meta: string
}

const toast = useToast()
const titleId = useId()

const orders = ref<Order[]>([
  { id: 1042, title: '№ 1042 · Ваза «Теракота»', meta: 'Олена К. · 1 240 ₴' },
  { id: 1043, title: '№ 1043 · Чашка «Вершки» ×4', meta: 'Максим Д. · 1 520 ₴' },
  { id: 1044, title: '№ 1044 · Миска «Шавлія»', meta: 'Ірина П. · 690 ₴' },
  { id: 1045, title: '№ 1045 · Тарілка «Ряба» ×6', meta: 'Андрій С. · 2 280 ₴' },
  { id: 1046, title: '№ 1046 · Ваза «Кобальт»', meta: 'Софія Л. · 1 180 ₴' },
  { id: 1047, title: '№ 1047 · Набір «Сніданок»', meta: 'Тарас М. · 3 450 ₴' },
  { id: 1048, title: '№ 1048 · Глечик «Льон»', meta: 'Наталія Г. · 980 ₴' },
])

// Два замовлення обрано одразу — щоб розкладку панелі було видно без кліку.
const selected = ref<number[]>([1043, 1044])
const allChecked = computed(() => selected.value.length === orders.value.length)

// «2 замовлення обрано», «5 замовлень обрано»: підпис стоїть після числа.
const pluralRules = new Intl.PluralRules('uk')
const label = computed(() =>
  pluralRules.select(selected.value.length) === 'many' ? 'замовлень обрано' : 'замовлення обрано',
)

function toggle(id: number, value: boolean) {
  selected.value = value ? [...selected.value, id] : selected.value.filter((item) => item !== id)
}

function toggleAll(value: boolean) {
  selected.value = value ? orders.value.map((order) => order.id) : []
}

function done(message: string) {
  toast.success(`${message}: ${selected.value.length}`)
  selected.value = []
}

function reject() {
  const count = selected.value.length
  orders.value = orders.value.filter((order) => !selected.value.includes(order.id))
  selected.value = []
  toast.success(`Відхилено замовлень: ${count}`)
}
</script>

<template>
  <!-- Бічна панель на ~420px — як дравер чи колонка CRM. Розкладку
       ActionBar обирає її ширина, а не ширина екрана: навіть на широкому
       моніторі лічильник і хрестик тут стоять угорі, а п'ять дій — під
       ними. На телефоні ряд дій гортається вбік. -->
  <section
    class="flex h-100 w-full max-w-md flex-col overflow-clip rounded-card border border-line bg-card shadow-card"
    :aria-labelledby="titleId"
  >
    <header class="flex items-center gap-3 border-b border-line px-4 py-3">
      <UiCheckbox
        :model-value="allChecked"
        :indeterminate="selected.length > 0 && !allChecked"
        @update:model-value="toggleAll"
      >
        <span class="sr-only">Обрати всі замовлення</span>
      </UiCheckbox>
      <!-- m-0: демо живе всередині .docs-prose, і відступи прозового h3
           (2em згори) зсували б назву нижче за чекбокс і лічильник. -->
      <h3 :id="titleId" class="m-0 min-w-0 flex-1 truncate text-sm font-semibold text-ink">Нові замовлення</h3>
      <span class="text-sm tabular-nums text-muted">{{ orders.length }}</span>
    </header>

    <!-- Область прокрутки — найближчий прокручуваний предок панелі, тож
         sticky прилипає до низу саме бічної панелі, а не вікна. -->
    <div class="min-h-0 flex-1 overflow-y-auto overscroll-contain px-3">
      <ul class="divide-y divide-line">
        <li v-for="order in orders" :key="order.id" class="px-1 py-2.5">
          <UiCheckbox
            :model-value="selected.includes(order.id)"
            :label="order.title"
            :description="order.meta"
            @update:model-value="toggle(order.id, $event)"
          />
        </li>
      </ul>

      <UiActionBar :open="selected.length > 0" :count="selected.length" :label="label" @dismiss="selected = []">
        <UiButton size="sm" @click="done('Підтверджено замовлень')">Підтвердити</UiButton>
        <UiButton variant="ghost" size="sm" @click="toast.info('Накладні готуються до друку')">Накладні</UiButton>
        <UiButton variant="ghost" size="sm" @click="done('Передано в роботу')">Змінити статус</UiButton>
        <UiButton variant="ghost" size="sm" @click="toast.info('Файл CSV готується')">Експорт</UiButton>
        <UiButton variant="danger" size="sm" @click="reject">Відхилити</UiButton>
      </UiActionBar>
    </div>
  </section>
</template>

```


## sticky чи fixed

- **`sticky`** (типово) — панель стоїть у потоці документа одразу після
  списку й прилипає до низу найближчої області прокрутки — вікна чи тіла
  дравера, — поки список видно. Tab доходить до неї природно, одразу після
  рядків. Ширину, а з нею й розкладку, панель бере від батька: у дравері
  на 400px вона складеться у два ряди навіть на широкому моніторі.
- **`fixed`** — панель телепортується в `<body>` і висить над усім
  застосунком; ширину й розкладку тоді диктує вікно. Це потрібно для
  глобальних станів, але телепорт ставить панель у кінець документа:
  після вибору рядків клавіатурою до неї довгий шлях. Тому переносьте
  фокус методом `focus()`.

Предок з `overflow: hidden` ламає `sticky`: такий контейнер стає власною
областю прокрутки, і панель липне до нього, а не до екрана. Якщо обрізання
потрібне для заокруглених кутів — беріть `overflow-clip`, він області
прокрутки не створює.

## API

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

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

- Масові дії над обраними записами: списки файлів, сітки фото, картки.
- Незбережені зміни у формі налаштувань, яку легко покинути, не
  зберігши.

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

- Для таблиці — у `UiTable` вже є слот `selection-actions` з тією самою
  роллю, прямо в шапці таблиці.
- Для однієї дії над одним записом — кнопка в рядку або меню рядка.
- Як місце для постійних дій сторінки — вони в `UiPageHeader`.

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

Панель — `role="region"` з назвою (`ariaLabel`), тож скрінрідер знаходить
її серед орієнтирів сторінки. Кількість обраного оголошує окремий
**постійно змонтований** live-регіон: регіон, що з'являється разом зі своїм
текстом, скрінрідери здебільшого пропускають.

Escape усередині панелі викликає `dismiss` і зупиняє подію — щоб він не
закрив ще й модалку за панеллю. Хрестик дрібний (30px), тож на дотику його
ціль добудовує невидима зона 45×45.

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


## Event descriptions

- `dismiss`: Хрестик або Escape усередині панелі. Батько знімає вибір чи відкидає зміни — панель сама не ховається.


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