API Docs for: 3.18.1

DOMEventFacade Class

Module: event-base
Parent Module: event

Wraps a DOM event, properties requiring browser abstraction are fixed here. Provids a security layer when required.

Methods

halt

(
  • immediate
)

Stops the event propagation and prevents the default event behavior.

Parameters:

  • immediate Boolean

    if true additional listeners on the current target will not be executed

preventDefault

(
  • returnValue
)

Prevents the event's default behavior

Parameters:

  • returnValue String

    sets the returnValue of the event to this value (rather than the default false value). This can be used to add a customized confirmation query to the beforeunload event).

stopImmediatePropagation

()

Stops the propagation to the next bubble target and prevents any additional listeners from being exectued on the current target.

stopPropagation

()

Stops the propagation to the next bubble target

Properties

_GESTURE_MAP

Object static

Provided by the event-touch module.

Defined in event/js/event-facade-dom-touch.js:172

A object literal with keys "start", "end", and "move". The value for each key is a string representing the event for that environment. For touch environments, the respective values are "touchstart", "touchend" and "touchmove". Mouse and MSPointer environments are also supported via feature detection.

altKey

Boolean

true if the "alt" or "option" key is pressed.

button

Number

The button that was pushed. 1 for left click, 2 for middle click, 3 for right click. This is only reliably populated on mouseup events.

changedTouches

DOMEventFacade[]

Provided by the event-touch module.

Defined in event/js/event-facade-dom-touch.js:81

An array of event-specific touch events.

For touchstart, the touch points that became active with the current event.

For touchmove, the touch points that have changed since the last event.

For touchend, the touch points that have been removed from the touch surface.

charCode

Number

The charCode for key events. Same as keyCode

clientX

Number

The X location of the event in the viewport

clientY

Number

The Y location of the event in the viewport

ctrlKey

Boolean

true if the "Ctrl" or "control" key is pressed.

currentTarget

Node

Node reference for the element that the listener was attached to.

keyCode

Number

The keyCode for key events. Uses charCode if keyCode is not available

metaKey

Boolean

true if the "Windows" key on a Windows keyboard, "command" key on an Apple keyboard, or "meta" key on other keyboards is pressed.

pageX

Number

The X location of the event on the page (including scroll)

pageY

Number

The Y location of the event on the page (including scroll)

relatedTarget

Node

Node reference to the relatedTarget

shiftKey

Boolean

true if the shift key is pressed.

target

Node

Node reference for the targeted element

targetTouches

DOMEventFacade[]

Provided by the event-touch module.

Defined in event/js/event-facade-dom-touch.js:58

Array of individual touch events still in contact with the touch surface and whose touchstart event occurred inside the same taregt element as the current target element.

touches

DOMEventFacade[]

Provided by the event-touch module.

Defined in event/js/event-facade-dom-touch.js:39

Array of individual touch events for touch points that are still in contact with the touch surface.

type

String

The name of the event (e.g. "click")

wheelDelta

Number

Number representing the direction and velocity of the movement of the mousewheel. Negative is down, the higher the number, the faster. Applies to the mousewheel event.

which

Number

The button that was pushed. Same as button.