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

Устаревшее и нестандартное mousewheel событие срабатывает асинхронно на Element для предоставления обновлений во время работы колёсиком мыши или аналогичным устройством. Событие mousewheel никогда не было частью какого-либо стандарта, и хотя оно реализовывалось несколькими браузерами, оно никогда не реализовывалось Firefox.

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

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

onmousewheel = (event) => {};

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

Этот интерфейс наследует свойства от своих предков, MouseEvent, UIEvent и Event.

WheelEvent.deltaX Только для чтения

Возвращает double, представляющее количество горизонтальной прокрутки.

WheelEvent.deltaY Только для чтения

Возвращает double, представляющее количество вертикальной прокрутки.

WheelEvent.deltaZ Только для чтения

Возвращает double, представляющее количество прокрутки по оси z.

WheelEvent.deltaMode Только для чтения

Возвращает unsigned long, представляющее единицу значения delta* для количества прокрутки. Допустимые значения:

Постоянная	Значение	Описание
WheelEvent.DOM_DELTA_PIXEL	0x00	Значения delta* задаются в пикселях.
WheelEvent.DOM_DELTA_LINE	0x01	Значения delta* задаются в строках. Каждый щелчок мышью прокручивает строку контента, где метод вычисления высоты строки зависит от браузера.
WheelEvent.DOM_DELTA_PAGE	0x02	Значения delta* задаются в страницах. Каждый щелчок мышью прокручивает страницу контента.

WheelEvent.wheelDelta Только для чтения Устаревшее

Возвращает целое число (32 бита), представляющее расстояние в пикселях.

WheelEvent.wheelDeltaX Только для чтения Устаревшее

Возвращает целое число, представляющее количество горизонтальной прокрутки.

WheelEvent.wheelDeltaY Только для чтения Устаревшее

Возвращает целое число, представляющее количество вертикальной прокрутки.

Значение свойства detail всегда равно нулю, за исключением Opera, которая использует detail аналогично значению detail события DOMMouseScroll, которое доступно только в Firefox, указывающему расстояние прокрутки в строках, причём отрицательные значения означают, что прокрутка направлена вниз или вправо, а положительные значения означают прокрутку вверх или влево.

На Linux, 2 или -2 устанавливается для каждого системного события колёсика.

Значение атрибута wheelDelta — абстрактное значение, показывающее, насколько повернулось колесо. Если колесо повернулось от пользователя, значение положительное, в противном случае — отрицательное. Это означает, что знак значения delta отличается от значения wheel события DOM Level 3. Однако смысл величины этих значений не одинаков в разных браузерах. См. объяснение ниже.

IE и Opera (Presto) поддерживают только атрибут wheelDelta и не поддерживают горизонтальную прокрутку.

Значение атрибута wheelDeltaX указывает значение атрибута wheelDelta по горизонтали. Если пользователь использует устройство для прокрутки вправо, значение отрицательное. В противном случае, если оно влево, значение положительное.

Значение атрибута wheelDeltaY указывает значение атрибута wheelDelta по вертикали. Знак значения совпадает со знаком значения атрибута wheelDelta.

В Windows значение такое же, как значение delta WM_MOUSEWHEEL или WM_MOUSEHWHEEL. А также значение не меняется, даже если размер прокрутки в настройках системы равен прокрутке на страницу, т.е. значение такое же, как в IE в Windows.

На Linux значение равно 120 или -120 для каждого системного события колёсика. Это приводит к поведению, аналогичному IE и Chrome для Windows.

На Mac значение сложное. Значение изменяется, если устройство, вызывающее системное событие колёсика, поддерживает непрерывную прокрутку.

Если устройство поддерживает непрерывную прокрутку (например, трекпад MacBook или колесо мыши, которое можно плавно поворачивать), значение вычисляется на основе ускоренного расстояния прокрутки. В этом случае значение такое же, как в Safari.

Если устройство не поддерживает непрерывную прокрутку (например, старое колесо мыши, которое нельзя плавно поворачивать), значение вычисляется на основе неускоренного расстояния прокрутки (120 на щелчок). В этом случае значение отличается от Safari.

Эта разница создаёт серьёзную проблему для разработчиков веб-приложений. То есть, разработчики веб-приложений не могут знать, вызвано ли событие mousewheel каким устройством.

Значение всегда вычисляется по ускоренному расстоянию прокрутки. Это действительно отличается от других браузеров, за исключением Chrome с поддержкой непрерывной прокрутки устройства.

Значение всегда равно значению атрибута detail ✕ 40.

В Windows, так как значение атрибута detail вычисляется из фактического расстояния прокрутки, значение отличается от других браузеров, за исключением случаев, когда размер прокрутки на щелчок равен 3 строкам в настройках системы или странице.

На Linux значение равно 80 или -80 для каждого системного события колёсика. Это отличается от других браузеров.

На Mac значение атрибута detail вычисляется на основе ускоренного расстояния прокрутки системного события. Значение обычно намного больше, чем в Safari или Chrome.

Не входит ни в одну спецификацию.

• Стандартное wheel событие для использования вместо него.