# Spinner

Індикатор очікування без відомої тривалості — у кнопці, рядку списку чи на місці панелі.


Коло з дугою, що обертається. Колір типово береться з тексту батька
(`tone="current"`), тож усередині суцільної кнопки спінер сам стає білим,
а в приглушеному рядку — приглушеним, без жодного props.


Example (app/demos/spinner/SpinnerBasic.vue):

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

const refreshing = shallowRef(false)

function refresh() {
  refreshing.value = true
  setTimeout(() => (refreshing.value = false), 1600)
}
</script>

<template>
  <div class="flex w-full max-w-md flex-col gap-6">
    <div class="flex items-center gap-5">
      <UiSpinner size="xs" tone="accent" />
      <UiSpinner size="sm" tone="accent" />
      <UiSpinner size="md" tone="accent" />
      <UiSpinner size="lg" tone="accent" />
      <UiSpinner size="md" tone="muted" label="Синхронізація" show-label />
    </div>

    <!-- Спінер у рядку списку: колір береться з тексту батька. -->
    <div class="flex items-center justify-between rounded-card border border-line bg-card px-4 py-3">
      <div class="min-w-0">
        <p class="text-sm font-medium text-ink">Замовлення за вересень</p>
        <p class="text-xs text-muted">Оновлено щойно</p>
      </div>
      <UiButton variant="outline" size="sm" :disabled="refreshing" @click="refresh">
        <template #leading>
          <UiSpinner v-if="refreshing" size="xs" />
          <svg v-else class="h-3.5 w-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true">
            <path d="M20 11a8 8 0 1 0-2.3 5.7M20 4v7h-7" />
          </svg>
        </template>
        {{ refreshing ? 'Оновлюємо…' : 'Оновити' }}
      </UiButton>
    </div>

    <!-- Панель, що вантажиться: aria-busy на контейнері, назва — на спінері. -->
    <div class="flex h-28 items-center justify-center rounded-card border border-dashed border-line-strong bg-subtle" aria-busy="true">
      <UiSpinner size="lg" tone="accent" label="Завантаження звіту" show-label />
    </div>
  </div>
</template>

```


## Спінер, скелетон чи прогрес

- **Skeleton** — коли відома *форма* того, що завантажується: список,
  картка, таблиця. Сітка не перебудовується в момент приходу даних.
- **Progress / ProgressRing** — коли відомо, *скільки* лишилось: upload,
  імпорт, пакетна операція.
- **Spinner** — коли не відомо ні форми, ні тривалості: оновлення рядка,
  перевірка поля, короткий запит.

## API

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

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

- Коротке очікування (до кількох секунд) на місці конкретного елемента:
  іконка кнопки «Оновити», статус рядка, перевірка унікальності поля.
- Завантаження панелі, форма вмісту якої невідома заздалегідь.

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

- Для кнопки, що надсилає форму, — у `UiButton` вже є `loading`, який ще й
  зберігає ширину кнопки.
- Для списків і карток — скелетон повторює геометрію і не змушує сторінку
  стрибати.
- Для довгих процесів. Через ~5 с спінер перестає переконувати, що щось
  відбувається: покажіть прогрес або дайте скасувати.

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

Без `label` спінер декоративний (`aria-hidden`): стан завантаження має
оголошувати контейнер через `aria-busy` або текст поруч. З `label` він стає
`role="status"` з текстом — видимим (`showLabel`) або лише для скрінрідера.

Live-регіон, що з'являється разом зі своїм текстом, скрінрідери часто
пропускають: оголошення надійне лише тоді, коли регіон існував ДО зміни.
Якщо завантаження важливо оголосити, тримайте постійний контейнер із
`role="status"` і міняйте його текст, а спінер лишіть декоративним.

Під `prefers-reduced-motion` обертання зупиняє глобальний вимикач — так
само, як у Progress і LoadingDots. Щоб застигле коло не читалося як
звичайна іконка, дуга тоді подовжується до трьох чвертей — впізнаваний
статичний гліф очікування.


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