This article needs a technical review. How you can help.
The pointerout event is fired for several reasons including: pointing device is moved out of the hit test boundaries of an element; firing the pointerup event for a device that does not support hover (see pointerup); after firing the pointercancel event (see pointercancel); when a pen stylus leaves the hover range detectable by the digitizer.
General info
- Specification
- Pointer Events
- Interface
- PointerEvent
- Bubbles
- Yes
- Cancelable
- Yes
- Target
- Document, Element
- Default Action
- Varies: when the pointer is primary, all default actions of
mouseout
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
// pointerout event handler
target.addEventListener("pointerout", function(ev) {
// Process the event
}, false);
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | No support[1] | 28.0 (28.0)[2] | 10 | No support | No support |
| On disabled form elements | No support | 44.0 (44.0)[3] | No support | No support | ? |
| Feature | Android | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|---|
| Basic support | No support | No support | No support | No support | No support | 10 | No support | No support |
| On disabled form elements | No support | No support | No support | No support | No support | ? | No support | No support |
[1] Chrome doesn't implement this feature yet. See bug 196799.
[2] Implemented in bug 822898 behind the preference dom.w3c_pointer_events.enabled, defaulting to false.
[3] Implemented in bug 218093.