跳转到主要内容

Element: pointerout event

{{APIRef("Pointer Events")}}

The pointerout event is fired for several reasons including: pointing device is moved out of the hit test boundaries of an element; firing the {{domxref("Element/pointerup_event", "pointerup")}}pointerup event for a device that does not support hover (see {{domxref("Element/pointerup_event", "pointerup")}}pointerup); after firing the {{domxref("Element/pointercancel_event", "pointercancel")}}pointercancel event (see {{domxref("Element/pointercancel_event", "pointercancel")}}pointercancel); when a pen stylus leaves the hover range detectable by the digitizer.

pointerout events have the same problems as {{domxref("Element/mouseout_event", "mouseout")}}mouseout. If the target element has child elements, pointerout and pointerover events fire as the pointer moves over the boundaries of these elements too, not just the target element itself. Usually, {{domxref("Element/pointerenter_event", "pointerenter")}}pointerenter and {{domxref("Element/pointerleave_event", "pointerleave")}}pointerleave events' behavior is more sensible, because they are not affected by moving into child elements.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

addEventListener("pointerout", (event) => { })

Alternatively, assign to the event handler property of the interface:

onpointerout = (event) => { }

Event type

A {{domxref("PointerEvent")}}PointerEvent. Inherits from {{domxref("Event")}}Event.

{{InheritanceDiagram("PointerEvent")}}

Examples

Using addEventListener():

const para = document.querySelector("p");

para.addEventListener("pointerout", (event) => {
  console.log("Pointer moved out");
});

Using the onpointerout event handler property (but note that this replaces other event listeners added using onpointerout, if any):

const para = document.querySelector("p");

para.onpointerout = (event) => {
  console.log("Pointer moved out");
};

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also