DOMAssistant.Events Module

The DOMAssistantEvents module offers various methods for adding and removing handlers for one or several events on an element. It also contains functionality for stopping default actions and bubbling of events.

addEvent(evt, func)

Adds an event handler to the current element. Multiple event handlers are supported, and the receiving funtion will have an event object reference and a this reference to the element it occurred on, no matter what web browser. For accessibility reasons, please make sure to only apply click events to elements that can handle them without JavaScript enabled.

Parameters

evt

Event to apply, specified as a string, without the "on" prefix.

func

Function to handle the event, specified as a function reference (without parentheses) or an anonymous function.

Return value

Element which called the method.

Example calls

$("container").addEvent("click", getListing);

$("container").addEvent("click", function (){
alert("Hello darling!");
});

removeEvent(evt, func)

Removes an event handler from the current element. Works only for function references, and not anonymous functions.

Parameters

evt

Event to remove, specified as a string, without the "on" prefix.

func

Function to stop from handling the event, specified as a function reference (without parentheses).

Return value

Element which called the method.

Example calls

$("container").removeEvent("click", getListing);

preventDefault(evt)

Prevents the default action of an event. Can be called from any function, and is not a method of any element.

Parameters

evt

Event to prevent the default action of.

Return value

None.

Example calls

DOMAssistant.preventDefault(eventReference);

cancelBubble(evt)

Cancels the bubbling of an event. Can be called from any function, and is not a method of any element.

Parameters

evt

Event to cancel the bubbling of.

Return value

None.

Example calls

DOMAssistant.cancelBubble(eventReference);