HTML pointermove DOM Event: Reference and Examples

When someone interacts with a webpage, the browser sends events to the relevant JavaScript code. The pointermove event happens when an active or hovering pointer changes position.

When pointermove happens

An active or hovering pointer changes position.

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">Use mouse, touch or pen here</div>
<p id="event-status" role="status">Waiting for pointermove...</p>
<script>
    const eventTarget = document.getElementById("demo-target");
    const eventStatus = document.getElementById("event-status");

    if (eventTarget) {
        eventTarget.addEventListener("pointermove", (eventDetails) => {
            eventStatus.textContent = "pointermove event received";
            console.log(eventDetails.type, eventDetails.target);
        });
    }
</script>

Reading the code

The browser listens for pointermove 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.

Move across the box and read clientX/clientY.

eventDetails.pointerType can be mouse, pen or touch, and clientX/clientY locate the pointer.

Pointer events work across several input devices. Touch events are tied to touch-capable platforms; when possible, prefer a pointer-based implementation with accessible keyboard controls.

Try it in your browser

Open the page, show the Console panel, and follow this test: Move across the box and read clientX/clientY. Then change one thing in the example and observe whether the event still fires.

Common Beginner Mistakes

• Expecting pointermove to fire without its required user action or browser condition.
• Move across the box and read clientX/clientY.
• Adding repeated event listeners without considering cleanup or unwanted side effects.

Key Takeaways

• pointermove reports an active or hovering pointer changes position.
• addEventListener("pointermove", ...) listens for the event on the appropriate target.
• Move across the box and read clientX/clientY.