Spec-Zone.ru › Web APIs

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

Устаревшее: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Избегайте её использования и, при возможности, обновите существующий код; см. таблицу совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

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

Событие DOM DOMMouseScroll срабатывает асинхронно при работе колесом мыши или аналогичного устройства, и накопленное смещение прокрутки превышает 1 строку или 1 страницу с момента последнего события. Оно представлено интерфейсом MouseScrollEvent. Это событие было реализовано только в Firefox. Вместо этого следует использовать стандартное событие wheel.

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

В Gecko 17 (Firefox 17) и более поздних версиях необходимо вызвать preventDefault() событий wheel, которые должны срабатывать для каждого нативного события.

Если доступно, используйте стандартное событие wheel.

Синтаксис

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

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

onDOMMouseScroll = (event) => {};

Тип события

A WheelEvent. Наследуется от MouseEvent, UIEvent и Event.

Событие UIEvent MouseEvent WheelEvent

Свойства события

У события есть только одно дополнительное свойство, помимо стандартных событий.

detail

Свойство detail более точно описывает прокрутку, при положительных значениях указывается прокрутка вниз, а при отрицательных — вверх.

Если событие представляет прокрутку вверх на страницу, значение detail равно -32768. Если событие указывает на прокрутку вниз на страницу, значение равно +32768. Любое другое значение представляет количество строк для прокрутки, при этом направление указывается знаком значения.

Примечание: Надежные события никогда не отправляются со значением 0 для detail.

Надежные события никогда не срабатывают со значением 0.

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

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

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

См. также

  • MouseScrollEvent
  • Завещание события прокрутки Gecko в пикселях: MozMousePixelScroll
  • Завещание события колесика мыши браузеров, не использующих Gecko: mousewheel
  • Стандартизованное событие колеса: wheel

© 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/DOMMouseScroll_event

Spec-Zone.ru

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