pointerenter

The pointerenter event fires when a pointing device is moved into the hit test boundaries of an element or one of its descendants, including as a result of a pointerdown event from a device that does not support hover (see pointerdown).

General info

Specification

Pointer Events

Interface

PointerEvent

Bubbles

No

Cancelable

No

Target

Document, Element

Default Action

Varies: When the pointer is primary, all default actions of mouseenter.

Properties

Property	Type	Description
target Read only	EventTarget	The event target (the topmost target in the DOM tree).
type Read only	DOMString	The type of event.
bubbles Read only	Boolean	Whether the event normally bubbles or not
cancelable Read only	Boolean	Whether the event is cancellable or not?
view Read only	WindowProxy	document.defaultView (window of the document)
detail Read only	long (float)	0.
pointerId Read only	long	A unique identifier for the pointer causing the event.
width Read only	double (float)	The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer.
height Read only	double (float)	The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer.
pressure Read only	float	The normalized pressure of the pointer input in the range of 0 to 1, where 0 and 1 represent the minimum and maximum pressure the hardware is capable of detecting, respectively.
tiltX Read only	long (float)	The plane angle (in degrees, in the range of -90 to 90) between the Y-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the Y axis.
tiltY Read only	long (float)	The plane angle (in degrees, in the range of -90 to 90) between the X-Z plane and the plane containing both the transducer (e.g. pen stylus) axis and the X axis.
pointerType Read only	string	Indicates the device type that caused the event. Must be one of the strings mouse, pen or touch, or an empty string.
isPrimary Read only	boolean	Indicates if the pointer represents the primary pointer of this pointer type.

Examples

// pointerenter event handler
target.addEventListener("pointerenter", function(ev) {
  // Process the event
}, false);

Browser compatibility

[1] Implemented in bug 822898 behind the preference dom.w3c_pointer_events.enabled, defaulting to false.

[2] Implemented in bug 218093.

See also

• pointerover
• pointerenter
• pointerdown
• pointermove
• pointerup
• pointercancel
• pointerout
• pointerleave
• gotpointercapture
• lostpointercapture