Carousel

Автовоспроизведение со счётчиком

Без автовоспроизведения

Свои слайды через слот

Входные параметры

ИмяТипПо умолчаниюОписание
imagesCarouselImage[][] Список слайдов. Каждый слайд: src (URL изображения) и alt? (альтернативный текст).
modelValuenumber0Текущий индекс слайда (управляется через v-model).
autoplaybooleanfalseВключает автовоспроизведение (переключение по таймеру).
intervalnumber4000Интервал автовоспроизведения в миллисекундах.
loopbooleantrueЗацикливание: возврат к первому слайду после последнего.
showArrowsbooleantrueПоказывать кнопки-стрелки переключения.
showDotsbooleantrueПоказывать точки-индикаторы слайдов.
showCounterbooleanfalseПоказывать счётчик «N / M».

События

ИмяАргументыКогда срабатывает
update:modelValueindex: numberПри переходе к слайду (поддерживает v-model).
changeindex: numberПри каждом переходе к другому слайду.

Описание

Карусель — слайдер изображений с горизонтальным треком, который сдвигается на текущий слайд. Поддерживает стрелки, точки-индикаторы, счётчик «N / M», автовоспроизведение и зацикливание.

Используйте её для демонстрации набора изображений (например, в каталоге или галерее). Текущий индекс можно контролировать через v-model, а сами слайды — кастомизировать через слот.

Дополнительная информация

  • Слот slide — scoped-slot { image, index } для кастомной отрисовки слайда; по умолчанию выводится <img> с alt.
  • Стрелки получают aria-label «Предыдущий слайд» / «Следующий слайд» и отключаются на границах, когда loop=false.
  • Точки — кнопки с aria-label и aria-current для активного слайда.
  • Невидимые слайды помечаются aria-hidden.
  • Автовоспроизведение приостанавливается при наведении (mouseenter/mouseleave) и запускается после монтирования, если autoplay включён и слайдов не меньше двух.
  • Индекс нормализуется по количеству слайдов, поэтому при loop границы циклируются.
×