PointerEvent extension type
The PointerEvent interface represents the state of a DOM event
produced by a pointer such as the geometry of the contact point, the device
type that generated the event, the amount of pressure that was applied on
the contact surface, etc.
A pointer is a hardware agnostic representation of input devices (such as a mouse, pen or contact point on a touch-enable surface). The pointer can target a specific coordinate (or set of coordinates) on the contact surface such as a screen.
A pointer's hit test is the process a browser uses to determine the target element for a pointer event. Typically, this is determined by considering the pointer's location and also the visual layout of elements in a document on screen media.
API documentation sourced from MDN Web Docs.
Constructors
- PointerEvent(String type, [PointerEventInit eventInitDict])
-
factory
Properties
- altKey → bool
-
The
MouseEvent.altKeyread-only property is a boolean value that indicates whether the alt key was pressed or not when a given mouse event occurs.no setterinherited - asString → String
-
Available on JSAny, provided by the JSAnyExtension extension
no setter - asString → String?
-
Available on JSAny?, provided by the JSAnyNullableExtension extension
no setter - bubbles → bool
-
The
bubblesread-only property of the Event interface indicates whether the event bubbles up through the DOM tree or not.no setterinherited -
The
MouseEvent.buttonread-only property indicates which button was pressed on the mouse to trigger the event.no setterinherited -
The
MouseEvent.buttonsread-only property indicates which buttons are pressed on the mouse (or other input device) when a mouse event is triggered.no setterinherited - cancelable → bool
-
The
cancelableread-only property of the Event interface indicates whether the event can be canceled, and therefore prevented as if the event never happened.no setterinherited - cancelBubble ↔ bool
-
The
cancelBubbleproperty of the Event interface is deprecated. Use Event.stopPropagation instead. Setting its value totruebefore returning from an event handler prevents propagation of the event. In later implementations, setting this tofalsedoes nothing. See Browser compatibility for details.getter/setter pairinherited -
client
→ Point<
num> -
Available on MouseEvent, provided by the EventGlue extension
A Point representation of the clientX and clientY properties of this MouseEvent.no setter -
clientPoint
→ Point<
num> -
Available on MouseEvent, provided by the MouseEventExtension extension
no setter - clientX → int
-
The
clientXread-only property of the MouseEvent interface provides the horizontal coordinate within the application's at which the event occurred (as opposed to the coordinate within the page).no setterinherited - clientY → int
-
The
clientYread-only property of the MouseEvent interface provides the vertical coordinate within the application's at which the event occurred (as opposed to the coordinate within the page).no setterinherited - composed → bool
-
The read-only
composedproperty of the Event interface returns a boolean value which indicates whether or not the event will propagate across the shadow DOM boundary into the standard DOM.no setterinherited - ctrlKey → bool
-
The
MouseEvent.ctrlKeyread-only property is a boolean value that indicates whether the ctrl key was pressed or not when a given mouse event occurs.no setterinherited - currentTarget → EventTarget?
-
The
currentTargetread-only property of the Event interface identifies the element to which the event handler has been attached.no setterinherited - defaultPrevented → bool
-
The
defaultPreventedread-only property of the Event interface returns a boolean value indicating whether or not the call to Event.preventDefault canceled the event.no setterinherited - detail → int
-
The
UIEvent.detailread-only property, when non-zero, provides the current (or next, depending on the event) click count.no setterinherited -
entries
→ Iterable<
MapEntry< String, dynamic> > -
Available on JSObject, provided by the JSObjectExtension extension
no setter - eventPhase → int
-
The
eventPhaseread-only property of the Event interface indicates which phase of the event flow is currently being evaluated.no setterinherited - hashCode → int
-
The hash code for this object.
no setterinherited
- height → double
-
The
heightread-only property of the PointerEvent interface represents the height of the pointer's contact geometry, along the y-axis (in CSS pixels). Depending on the source of the pointer device (for example a finger), for a given pointer, each event may produce a different value.no setter - isDefinedAndNotNull → bool
-
Available on JSAny?, provided by the NullableUndefineableJSAnyExtension extension
no setter - isElement → bool
-
Available on JSObject?, provided by the JSObjectWebExtension extension
no setter - isHTMLElement → bool
-
Available on JSObject?, provided by the JSObjectWebExtension extension
no setter - isNode → bool
-
Available on JSObject?, provided by the JSObjectWebExtension extension
no setter - isNull → bool
-
Available on JSAny?, provided by the NullableUndefineableJSAnyExtension extension
Whether this value corresponds to JavaScriptnull.no setter - isPrimary → bool
-
The
isPrimaryread-only property of the PointerEvent interface indicates whether or not the pointer device that created the event is the primary pointer. It returnstrueif the pointer that caused the event to be fired is the primary one and returnsfalseotherwise.no setter - isTrusted → bool
-
The
isTrustedread-only property of the Event interface is a boolean value that istruewhen the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus), andfalsewhen the event was dispatched via EventTarget.dispatchEvent. The only exception is theclickevent, which initializes theisTrustedproperty tofalsein user agents.no setterinherited - isTruthy → JSBoolean
-
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result of!!in JavaScript.thisno setter - isUndefined → bool
-
Available on JSAny?, provided by the NullableUndefineableJSAnyExtension extension
Whether this value corresponds to JavaScriptundefined.no setter - isUndefinedOrNull → bool
-
Available on JSAny?, provided by the NullableUndefineableJSAnyExtension extension
no setter -
keys
→ Iterable<
String> -
Available on JSObject, provided by the JSObjectExtension extension
no setter - metaKey → bool
-
The
MouseEvent.metaKeyread-only property is a boolean value that indicates whether the meta key was pressed or not when a given mouse event occurs.no setterinherited - movementX → double
-
The
movementXread-only property of the MouseEvent interface provides the difference in the X coordinate of the mouse pointer between the given event and the previousElement.mousemove_eventevent. In other words, the value of the property is computed like this:currentEvent.movementX = currentEvent.screenX - previousEvent.screenX.no setterinherited - movementY → double
-
The
movementYread-only property of the MouseEvent interface provides the difference in the Y coordinate of the mouse pointer between the given event and the previousElement.mousemove_eventevent. In other words, the value of the property is computed like this:currentEvent.movementY = currentEvent.screenY - previousEvent.screenY.no setterinherited - not → JSBoolean
-
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result of!in JavaScript.thisno setter -
offsetPoint
→ Point<
num> -
Available on MouseEvent, provided by the MouseEventExtension extension
no setter - offsetX → double
-
The
offsetXread-only property of the MouseEvent interface provides the offset in the X coordinate of the mouse pointer between that event and the padding edge of the target node.no setterinherited - offsetY → double
-
The
offsetYread-only property of the MouseEvent interface provides the offset in the Y coordinate of the mouse pointer between that event and the padding edge of the target node.no setterinherited -
pagePoint
→ Point<
num> -
Available on MouseEvent, provided by the MouseEventExtension extension
no setter - pageX → double
-
The
pageXread-only property of the MouseEvent interface returns the X (horizontal) coordinate (in pixels) at which the mouse was clicked, relative to the left edge of the entire document. This includes any portion of the document not currently visible.no setterinherited - pageY → double
-
The
pageYread-only property of the MouseEvent interface returns the Y (vertical) coordinate (in pixels) at which the mouse was clicked, relative to the top edge of the entire document. This includes any portion of the document not currently visible.no setterinherited - pointerId → int
-
The
pointerIdread-only property of the PointerEvent interface is an identifier assigned to a given pointer event. The identifier is unique, being different from the identifiers of all other active pointer events. Since the value may be randomly generated, it is not guaranteed to convey any particular meaning.no setter - pointerType → String
-
The
pointerTyperead-only property of the PointerEvent interface indicates the device type (mouse, pen, or touch) that caused a given pointer event.no setter - pressure → double
-
The
pressureread-only property of the PointerEvent interface indicates the normalized pressure of the pointer input.no setter -
The
MouseEvent.relatedTargetread-only property is the secondary target for the mouse event, if there is one.no setterinherited - returnValue ↔ bool
-
The Event property
returnValueindicates whether the default action for this event has been prevented or not.getter/setter pairinherited - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
screenPoint
→ Point<
num> -
Available on MouseEvent, provided by the MouseEventExtension extension
no setter - screenX → int
-
The
screenXread-only property of the MouseEvent interface provides the horizontal coordinate (offset) of the mouse pointer in screen coordinates.no setterinherited - screenY → int
-
The
screenYread-only property of the MouseEvent interface provides the vertical coordinate (offset) of the mouse pointer in screen coordinates.no setterinherited - shiftKey → bool
-
The
MouseEvent.shiftKeyread-only property is a boolean value that indicates whether the shift key was pressed or not when a given mouse event occurs.no setterinherited - srcElement → EventTarget?
-
The deprecated
Event.srcElementis an alias for the Event.target property. Use Event.target instead.no setterinherited - tangentialPressure → double
-
The
tangentialPressureread-only property of the PointerEvent interface represents the normalized tangential pressure of the pointer input (also known as barrel pressure or cylinder stress).no setter - target → EventTarget?
-
The read-only
targetproperty of the Event interface is a reference to the object onto which the event was dispatched. It is different from Event.currentTarget when the event handler is called during the bubbling or capturing phase of the event.no setterinherited - tiltX → int
-
The
tiltXread-only property of the PointerEvent interface is the angle (in degrees) between the Y-Z plane of the pointer and the screen. This property is typically only useful for a pen/stylus pointer type.no setter - tiltY → int
-
The
tiltYread-only property of the PointerEvent interface is the angle (in degrees) between the X-Z plane of the pointer and the screen. This property is typically only useful for a pen/stylus pointer type.no setter - timeStamp → double
-
The
timeStampread-only property of the Event interface returns the time (in milliseconds) at which the event was created.no setterinherited - twist → int
-
The
twistread-only property of the PointerEvent interface represents the clockwise rotation of the pointer (e.g., pen stylus) around its major axis, in degrees.no setter - type → String
-
The
typeread-only property of the Event interface returns a string containing the event's type. It is set when the event is constructed and is the name commonly used to refer to the specific event, such asclick,load, orerror.no setterinherited - view → Window?
-
The
UIEvent.viewread-only property returns the object from which the event was generated. In browsers, this is the Window object the event happened in.no setterinherited - which → int
-
The
UIEvent.whichread-only property of the UIEvent interface returns a number that indicates which button was pressed on the mouse, or the numerickeyCodeor the character code (charCode) of the key pressed on the keyboard.no setterinherited - width → double
-
The
widthread-only property of the PointerEvent interface represents the width of the pointer's contact geometry along the x-axis, measured in CSS pixels. Depending on the source of the pointer device (such as a finger), for a given pointer, each event may produce a different value.no setter - x → double
-
The
MouseEvent.xproperty is an alias for the MouseEvent.clientX property.no setterinherited - y → double
-
The
MouseEvent.yproperty is an alias for the MouseEvent.clientY property.no setterinherited
Methods
-
add(
JSAny? any) → JSAny -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this+any -
and(
JSAny? any) → JSAny? -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this&&any -
as<
T extends JSObject> () → T? -
Available on JSObject, provided by the JSObjectExtension extension
-
callMethod<
R extends JSAny?> (JSAny method, [JSAny? arg1, JSAny? arg2, JSAny? arg3, JSAny? arg4]) → R -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Callsmethodon this JSObject with up to four arguments. -
callMethodVarArgs<
R extends JSAny?> (JSAny method, [List< JSAny?> ? arguments]) → R -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Callsmethodon this JSObject with a variable number ofarguments. -
composedPath(
) → JSArray< EventTarget> -
The
composedPath()method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.inherited -
dartify(
) → Object? -
Available on JSAny?, provided by the JSAnyUtilityExtension extension
Converts a JavaScript JSON-like value to the Dart equivalent if possible. -
delete(
JSAny property) → JSBoolean -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Deletes the property with keypropertyfrom this JSObject. -
divide(
JSAny? any) → JSAny -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this/any -
equals(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this==any -
exponentiate(
JSAny? any) → JSAny -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this**any -
get(
String key) → Object? -
Available on JSObject, provided by the JSObjectExtension extension
-
getCoalescedEvents(
) → JSArray< PointerEvent> -
The
getCoalescedEvents()method of the PointerEvent interface returns a sequence ofPointerEventinstances that were coalesced (merged) into a singleElement.pointermove_eventorElement.pointerrawupdate_eventevent. Instead of a stream of manyElement.pointermove_eventevents, user agents coalesce multiple updates into a single event. This helps with performance as the user agent has less event handling to perform, but there is a reduction in the granularity and accuracy when tracking, especially with fast and large movements. -
getModifierState(
String keyArg) → bool -
The
MouseEvent.getModifierState()method returns the current state of the specified modifier key:trueif the modifier is active (i.e., the modifier key is pressed or locked), otherwise,false.inherited -
getPredictedEvents(
) → JSArray< PointerEvent> -
The
getPredictedEvents()method of the PointerEvent interface returns a sequence ofPointerEventinstances that are estimated future pointer positions. How the predicted positions are calculated depends on the user agent, but they are based on past points, current velocity, and trajectory. -
getProperty<
R extends JSAny?> (JSAny property) → R -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
The value of the property keypropertyof this JSObject. -
greaterThan(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this>any -
greaterThanOrEqualTo(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this>=any -
has(
String property) → bool -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Shorthand helper for hasProperty to check whether this JSObject contains the property keyproperty, but takes and returns a Dart value. -
hasProperty(
JSAny property) → JSBoolean -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Whether or not this JSObject contains the property keyproperty. -
initEvent(
String type, [bool bubbles, bool cancelable]) → void -
The
Event.initEvent()method is used to initialize the value of aneventcreated using Document.createEvent.inherited -
initMouseEvent(
String typeArg, [bool bubblesArg, bool cancelableArg, Window? viewArg, int detailArg, int screenXArg, int screenYArg, int clientXArg, int clientYArg, bool ctrlKeyArg, bool altKeyArg, bool shiftKeyArg, bool metaKeyArg, int buttonArg, ]) → void -
The
MouseEvent.initMouseEvent()method initializes the value of a mouse event once it's been created (normally using the Document.createEvent method).inherited -
initUIEvent(
String typeArg, [bool bubblesArg, bool cancelableArg, Window? viewArg, int detailArg]) → void -
The
UIEvent.initUIEvent()method initializes a UI event once it's been created.inherited -
instanceof(
JSFunction constructor) → bool -
Available on JSAny?, provided by the JSAnyUtilityExtension extension
Whether thisJSAny?is aninstanceofconstructor. -
instanceOfString(
String constructorName) → bool -
Available on JSAny?, provided by the JSAnyUtilityExtension extension
Whether thisJSAny?is aninstanceofthe constructor that is defined byconstructorName, which is looked up in the globalContext. -
isA<
T extends JSAny?> () → bool -
Available on JSAny?, provided by the JSAnyUtilityExtension extension
Whether thisJSAny?is an instance of the JavaScript type that is declared byT. -
lessThan(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this<any -
lessThanOrEqualTo(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this<=any -
modulo(
JSAny? any) → JSAny -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this%any -
multiply(
JSAny? any) → JSAny -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this*any -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
notEquals(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this!=any -
or(
JSAny? any) → JSAny? -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this||any -
preventDefault(
) → void -
The
preventDefault()method of the Event interface tells the that if the event does not get explicitly handled, its default action should not be taken as it normally would be.inherited -
put(
Object key, Object? value) → void -
Available on JSObject, provided by the JSObjectExtension extension
-
setProperty(
JSAny property, JSAny? value) → void -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Write thevalueof property keypropertyof this JSObject. -
stopImmediatePropagation(
) → void -
The
stopImmediatePropagation()method of the Event interface prevents other listeners of the same event from being called.inherited -
stopPropagation(
) → void -
The
stopPropagation()method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases. It does not, however, prevent any default behaviors from occurring; for instance, clicks on links are still processed. If you want to stop those behaviors, see the Event.preventDefault method. It also does not prevent propagation to other event-handlers of the current element. If you want to stop those, see Event.stopImmediatePropagation.inherited -
strictEquals(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this===any -
strictNotEquals(
JSAny? any) → JSBoolean -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this!==any -
subtract(
JSAny? any) → JSAny -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this-any -
toMap(
) → Map< String, dynamic> -
Available on JSObject, provided by the JSObjectExtension extension
-
toString(
) → String -
A string representation of this object.
inherited
-
typeofEquals(
String typeString) → bool -
Available on JSAny?, provided by the JSAnyUtilityExtension extension
Whether the result oftypeofon thisJSAny?istypeString. -
unsignedRightShift(
JSAny? any) → JSNumber -
Available on JSAny?, provided by the JSAnyOperatorExtension extension
The result ofin JavaScript.this>>>any
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
-
operator [](
String property) → JSAny? -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Shorthand helper for getProperty to get the value of the property keypropertyof this JSObject, but takes a Dart value. -
operator []=(
String property, JSAny? value) → void -
Available on JSObject, provided by the JSObjectUnsafeUtilExtension extension
Shorthand helper for setProperty to write thevalueof the property keypropertyof this JSObject, but takes a Dart value.