Нажмите кнопку «Следующее фото» на тестовой карточке и посмотрите, изменился ли индекс активного слайда. Если индекс прежний, ищите проблему в обработчике или блокировке кнопки. Если индекс меняется, а фото остаётся на месте, сравните позицию ленты и размеры слайдов. Это разделяет ошибку состояния и ошибку движения.

Сначала используйте галерею из трёх уже загруженных фотографий без автопрокрутки. Одно фото не показывает переход, а бесконечный режим с копиями слайдов добавляет лишние индексы. Когда простой вариант работает, возвращайте подгрузку, циклический переход и свайп по отдельности.

Стрелка, миниатюра и фото должны указывать на один объект

ПризнакКуда смотреть
Кнопка нажалась, индекс прежнийdisabled, обработчик, повторная инициализация
Индекс новый, лента прежняяtransform, рассчитанная ширина и transition
Лента сдвинулась, миниатюра стараяотдельное состояние выбранного фото
Вторая галерея меняет первуюглобальный поиск элементов и общие переменные

После изменения размера окна библиотека может использовать старую ширину слайда. Сравните фактическую ширину контейнера и шаг смещения в инспекторе. Слайд с margin или gap нельзя двигать по формуле, которая учитывает только ширину картинки. Убедитесь также, что CSS другого компонента не перезаписал transform самой ленты.

Проверяем обычное переключение без расчёта ленты

// Условный простой просмотр: slides и counter переданы компонентом.
// Требует непустого набора и одного начального render(0).
let index = 0;
function render(next) {
  index = (next + slides.length) % slides.length;
  slides.forEach((slide, i) => { slide.hidden = i !== index; });
  counter.textContent = (index + 1) + ' / ' + slides.length;
}
nextButton.addEventListener('click', () => render(index + 1));
prevButton.addEventListener('click', () => render(index - 1));

Это диагностический упрощённый режим без анимации, свайпа и клонированных слайдов. Он помогает установить, исправны ли данные и выбор фотографии. Все переменные относятся к одному экземпляру. Для пустого набора нужен отдельный экран, для одного изображения можно скрыть навигацию. Не вставляйте фрагмент параллельно существующей библиотеке: появится второй владелец состояния.

Свайп может быть отменён браузером

При pointer-жестах учитывайте pointercancel. Браузер может решить, что пользователь прокручивает страницу, и отменить текущий жест. Состояние dragging после отмены нужно сбросить, иначе следующий свайп будет игнорироваться. MDN связывает это поведение с политикой touch-action; запрет всех жестов на всей странице не является безопасным универсальным исправлением.

Сохраните вертикальную прокрутку страницы и масштабирование. Настройку области горизонтального жеста выбирайте вместе с поведением библиотеки и тестируйте на телефоне. Если пользователь начал свайп по галерее, затем ушёл за её пределы, компонент должен завершить или отменить попытку предсказуемо. Маленькая зона навигации и перекрывающий слой могут принимать касание вместо самой галереи.

  • Короткое касание без листания.
  • Горизонтальный жест в обе стороны.
  • Вертикальная прокрутка через область фотографии.
  • Отмена жеста и следующий повтор.
  • Поворот телефона и повторный переход.

Кнопки остаются полноценным способом просмотра

Не оставляйте свайп единственным управлением. У кнопок должны быть понятные названия, видимый фокус и предсказуемый переход. APG описывает доступную карусель, включая управление автоматическим вращением. Для товарных фото проще сначала отказаться от автолистания: читатель сам выбирает, какую деталь рассмотреть.

Исправление проверяют на первой, средней и последней фотографии, а также во втором экземпляре галереи. После смены товара убедитесь, что прежний индекс не выходит за размер нового набора. Для воспроизведения подготовьте массив обезличенных фото, последовательность нажатий, значения индекса и ширины ленты. Они позволяют отделить поломку навигации от отдельной задачи открытия увеличенного lightbox.

Проверенные источники