When someone interacts with a webpage, the browser sends events to the relevant JavaScript code. The wheel event happens when a wheel or trackpad scrolling gesture occurs.
When wheel happens
A wheel or trackpad scrolling gesture occurs.
You can listen for it using addEventListener(). That keeps event handling separate from HTML attributes such as onclick and works well with modern code organization.
A small working example
<div id="demo-target" style="padding: 2rem; border: 1px solid">Move your pointer here</div>
<p id="event-status" role="status">Waiting for wheel...</p>
<script>
const eventTarget = document.getElementById("demo-target");
const eventStatus = document.getElementById("event-status");
if (eventTarget) {
eventTarget.addEventListener("wheel", (eventDetails) => {
eventStatus.textContent = "wheel event received";
console.log(eventDetails.type, eventDetails.target);
});
}
</script>Reading the code
The browser listens for wheel on the relevant target. When the event occurs, the callback receives eventDetails, updates the status message and logs the event name and target in Developer Tools.
Scroll over the target; wheel events do not necessarily mean scrolling happened.
eventDetails.deltaY indicates wheel movement, which need not cause scrolling.
Try it in your browser
Open the page, show the Console panel, and follow this test: Scroll over the target; wheel events do not necessarily mean scrolling happened. Then change one thing in the example and observe whether the event still fires.
Common Beginner Mistakes
- Expecting
wheelto fire without its required user action or browser condition. - Scroll over the target; wheel events do not necessarily mean scrolling happened.
- Adding repeated event listeners without considering cleanup or unwanted side effects.
Key Takeaways
wheelreports a wheel or trackpad scrolling gesture occurs.addEventListener("wheel", ...)listens for the event on the appropriate target.- Scroll over the target; wheel events do not necessarily mean scrolling happened.