Нажмите кнопку «Следующее фото» на тестовой карточке и посмотрите, изменился ли индекс активного слайда. Если индекс прежний, ищите проблему в обработчике или блокировке кнопки. Если индекс меняется, а фото остаётся на месте, сравните позицию ленты и размеры слайдов. Это разделяет ошибку состояния и ошибку движения.
Сначала используйте галерею из трёх уже загруженных фотографий без автопрокрутки. Одно фото не показывает переход, а бесконечный режим с копиями слайдов добавляет лишние индексы. Когда простой вариант работает, возвращайте подгрузку, циклический переход и свайп по отдельности.
Стрелка, миниатюра и фото должны указывать на один объект
| Признак | Куда смотреть |
|---|---|
| Кнопка нажалась, индекс прежний | 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.