The wheel event fires when the user rotates a wheel button on a pointing device (typically a mouse).

This event replaces the non-standard deprecated mousewheel event.

Bubbles Yes
Cancelable Yes
Interface WheelEvent
Event handler property onwheel

Note: Don't confuse the wheel event with the scroll event. The default action of a wheel event is implementation-specific, and doesn't necessarily dispatch a scroll event. Even when it does, the delta* values in the wheel event don't necessarily reflect the content's scrolling direction. Therefore, do not rely on the wheel event's delta* properties to get the scrolling direction. Instead, detect value changes of scrollLeft and scrollTop in the scroll event.

Examples

TBD

Specifications

Specification Status Comment
Document Object Model (DOM) Level 3 Events Specification
The definition of 'wheel' in that specification.
Obsolete Initial definition.

Browser compatibility

No compatibility data found. Please contribute data for "api.Element.wheel_event" (depth: 1) to the MDN compatibility data repository.

See also