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
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | 55.0 | (Yes) | 28.0 (28.0)[1] | 11 | 42 | No support |
| On disabled form elements | No support | No support | 44.0 (44.0)[2] | No support | No support | ? |
| Feature | Android | Android Webview | Edge | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|---|
| Basic support | No support | 55.0 | (Yes) | No support | No support | 11 | 42 | No support | 55.0 |
| On disabled form elements | No support | No support | No support | No support | No support | ? | No support | No support | No support |
[1] Implemented in bug 822898 behind the preference dom.w3c_pointer_events.enabled, defaulting to false.
[2] Implemented in bug 218093.