Spec-Zone.ru › Web APIs

Элемент: событие scrollsnapchange

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Экспериментально: Это экспериментальная технология
Перед использованием в производстве тщательно проверьте таблицу совместимости с браузерами.

Событие scrollsnapchange интерфейса Element срабатывает в элементе-контейнере прокрутки по завершении операции прокрутки, когда выбран новый целевой элемент прокрутки, непосредственно перед срабатыванием соответствующего события scrollend.

Операция прокрутки заканчивается, когда пользователь завершает прокрутку внутри контейнера прокрутки — например, используя жесты касания или перетаскивая указатель мыши по полосе прокрутки — и отпускает этот жест.

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.

addEventListener("scrollsnapchange", (event) => {});

onscrollsnapchange = (event) => {};

Тип события

Тип SnapEvent, который наследуется от универсального типа Event.

Примеры

Базовое использование

Предположим, у нас есть элемент <main> с важным содержимым, которое вызывает прокрутку:

<main>
  <!-- Significant content -->
</main>

Элемент <main> можно преобразовать в контейнер прокрутки, который будет прокручиваться к своим дочерним элементам, используя комбинацию свойства CSS scroll-snap-type и других свойств. Например:

main {
  width: 250px;
  height: 450px;
  overflow: scroll;
  scroll-snap-type: block mandatory;
}

Следующий фрагмент JavaScript вызовет срабатывание события scrollsnapchange в элементе <main> при переходе к одному из его дочерних элементов, ставшего новым целевым элементом прокрутки. В обработчике функции мы задаем класс selected для дочернего элемента, на который ссылается свойство SnapEvent.snapTargetBlock, что может быть использовано для стилизации его отображения как выбранного (например, с анимацией) при срабатывании события.

const scrollingElem = document.querySelector("main");

scrollingElem.addEventListener("scrollsnapchange", (event) => {
  event.snapTargetBlock.classList.add("selected");
});

Спецификации

Спецификация
CSS Scroll Snap Module Level 2
# scrollsnapchange

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
scrollsnapchange_event 129 129 Нет 115 Нет 129 Нет 86 Нет Нет 129

См. также

  • scrollsnapchanging событие
  • scrollend событие
  • SnapEvent
  • CSS scroll-snap-type свойство
  • Модуль CSS scroll snap
  • Использование событий scroll snap
  • События Scroll Snap на developer.chrome.com (2024)

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollsnapchange_event

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API