# Stepper

Індикатор кроків майстра налаштувань — з прогресом, галочками і режимом кліків.


Stepper відрізняється від Tabs тим, що несе СТАН ПРОГРЕСУ: пройдені
кроки позначені галочками, майбутні — приглушені, активний — виділений.
Tabs нічого не говорить про порядок і не пам'ятає, де користувач був.

## Приклад


Example (app/demos/stepper/StepperBasic.vue):

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

const step = ref(1)
</script>

<template>
  <div class="w-full max-w-xl">
    <UiStepper
      v-model="step"
      :steps="[
        { id: 'site', label: 'Сайт', description: 'Базові поля' },
        { id: 'content', label: 'Контент' },
        { id: 'publish', label: 'Публікація' },
      ]"
    />
    <p class="mt-2 text-xs text-muted">Крок {{ step + 1 }} з 3 — клікайте по кроках або ведіть станом.</p>
  </div>
</template>
```


## Вертикальний і стан кроку

`orientation="vertical"` ставить кроки стовпчиком — для бокової панелі
майстра і вузьких екранів. Поле `status` у кроці задає стан поверх
позиції: `error` — на кроці є помилка (червоний індикатор, озвучується
«помилка»), `complete` — крок пройдено навіть попереду поточного, для
нелінійних майстрів.


Example (app/demos/stepper/StepperVertical.vue):

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

const step = ref(2)
</script>

<template>
  <div class="w-full max-w-sm">
    <UiStepper
      v-model="step"
      orientation="vertical"
      aria-label="Кроки імпорту"
      :steps="[
        { id: 'file', label: 'Файл', description: 'products.csv' },
        { id: 'mapping', label: 'Відповідність полів', description: '2 поля без пари', status: 'error' },
        { id: 'preview', label: 'Перегляд', description: '1 240 рядків' },
        { id: 'import', label: 'Імпорт' },
      ]"
    />
  </div>
</template>

```


## Прогрес і режими кліків

У лінійному майстрі (`visited` і `none`) компонент пам'ятає найдальший
крок, до якого дійшли: повернення назад не стирає галочки пройдених
кроків, а в `visited` до них можна повернутися кліком. Щоб почати майстер
спочатку, змініть `:key` компонента.

`clickMode="none"` рендерить кроки текстом, а не вимкненими кнопками:
пройдений прогрес не виглядає «недоступним» і не озвучується так.

## API

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

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

Майстри налаштувань: онбординг, публікація за три кроки, візарди
імпорту. Поряд — кнопки «Назад»/«Далі» споживача, які ведуть той самий
`v-model`.

`clickMode="visited"` дозволяє повертатись по пройдених кроках, але не
стрибати вперед — користувач не пропустить жодного кроку випадково.

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

Для перемикання вмісту без порядку — це Tabs: вкладки не псують
прогрес, бо прогресу там немає.

Для кроків, які не можна пропускати, не задавайте `clickMode="any"`.

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

Кроки — список `<ol>`: скрінрідер повідомляє кількість і позицію кроку.
`aria-current="step"` позначає активний крок; пройдені — галочка з
контрастним текстом і прихований текст «завершено» (галочка заміщує
номер, і без нього пройдений крок звучав рівно як майбутній), крок зі
`status: 'error'` — «помилка». У `compact` назва кроку лишається для
скрінрідера. Деактивовані кроки `disabled` і недоступні як вибір.

Кружечок кроку — 30px, тож на дотику кнопку добудовує невидима зона
45×45.

Горизонтальний ряд нижче `sm` показує підпис лише активного кроку, решта —
кружечки й лінії (підписи лишаються для скрінрідера). Три кроки з
підписами на 375px не вміщались і виїжджали за край: пункти ряду тягнуться
з нульової основи й перенестися на новий рядок не можуть. Активний підпис
обрізається трикрапкою. Задайте `aria-label`, якщо на сторінці кілька степперів.

## Event descriptions

- `update:modelValue`: Активний крок (0-based). Використовуйте через `v-model`.
- `change`: Активний крок змінився.


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