Skip to content

SStepper

Индикатор шагов многошагового сценария (мастер, воронка): пройденные шаги отмечаются галочкой и позволяют вернуться назад кликом, будущие шаги открываются самим сценарием.

В чем отличие от аналогов?

В отличие от популярных библиотек компонентов для Vue3:

  1. Формат шагов взаимозаменяем с опциями SSelect и SRadioGroup — те же map/массивы, ничего не нужно переформатировать.
  2. Навигация ограничена пройденными шагами из коробки: движение вперёд контролирует сценарий, а не пользователь.

Базовый пример

Понимание тематики
Тематические сайты
3Предпросмотр
<SStepper v-model="step" :options="steps" />

Шаги до текущего считаются пройденными: получают галочку и становятся кликабельными — клик возвращает модель на выбранный шаг. Шаги после текущего неактивны.

Массив строк

Если значения шагов не нужны, достаточно массива строк — значением модели будет сама строка:

Загрузка
2Предпросмотр
3Готово
<SStepper v-model="step" :options="['Загрузка', 'Предпросмотр', 'Готово']" />

Интерфейс компонента

Свойства (Props)

НазваниеТипПо умолчаниюОписание
v-modelanyundefinedЗначение текущего шага. Если значение не найдено среди шагов, активным считается первый шаг.
optionsRecord | Array{}Шаги (объект {value: title}, массив [[value, title]], массив объектов {value, label} или массив строк).

События (Emits)

НазваниеPayloadОписание
update:modelValueanyКлик по пройденному шагу — возврат на него.