HTML pointerleave DOM Event: Reference and Examples

When someone interacts with a webpage, the browser sends events to the relevant JavaScript code. The pointerleave event happens when a pointer moves out of the element's boundaries.

When pointerleave happens

A pointer moves out of the element's boundaries.

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 pointerleave...</p>
<script>
    const eventTarget = document.getElementById("demo-target");
    const eventStatus = document.getElementById("event-status");

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

Reading the code

The browser listens for pointerleave 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 the pointer outside; pointerleave does not bubble.

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 the pointer outside; pointerleave does not bubble. Then change one thing in the example and observe whether the event still fires.

Common Beginner Mistakes

• Expecting pointerleave to fire without its required user action or browser condition.
• Move the pointer outside; pointerleave does not bubble.
• Adding repeated event listeners without considering cleanup or unwanted side effects.

Key Takeaways

• pointerleave reports a pointer moves out of the element's boundaries.
• addEventListener("pointerleave", ...) listens for the event on the appropriate target.
• Move the pointer outside; pointerleave does not bubble.