Yahoo! UI Library

event  3.0.0

Yahoo! UI Library > event > DOMEventFacade

Class DOMEventFacade

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


_event - object

The native event

button - int

The button that was pushed.

charCode - int

The charCode for key events. Same as keyCode

currentTarget - Node

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

keyCode - int

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

pageX - int

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

pageY - int

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

relatedTarget - Node

Node reference to the relatedTarget

target - Node

Node reference for the targeted element

webkitKeymap - private object

webkit key remapping required for Safari < 3.1

wheelDelta - int

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 - int

The button that was pushed. Same as button.



void halt ( immediate )
Stops the event propagation and prevents the default event behavior.
immediate <boolean> if true additional listeners on the current target will not be executed


void preventDefault ( returnValue )
Prevents the event's default behavior
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).


private void resolve ( )
Returns a wrapped node. Intended to be used on event targets, so it will return the node's parent if the target is a text node. If accessing a property of the node throws an error, this is probably the anonymous div wrapper Gecko adds inside text nodes. This likely will only occur when attempting to access the relatedTarget. In this case, we now return null because the anonymous div is completely useless and we do not know what the related target was because we can't even get to the element's parent node.


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


void stopPropagation ( )
Stops the propagation to the next bubble target

Copyright © 2009 Yahoo! Inc. All rights reserved.