Name
EventTarget.addEventListener( ) — register an event handler
Availability
DOM Level 2 Events
Synopsis
void addEventListener(Stringtype, EventListenerlistener, booleanuseCapture);
Arguments
-
type The type of event for which the event listener is to be invoked. For example, “load”, “click”, or “mousedown”.
-
listener The event listener function that will be invoked when an event of the specified type is dispatched to this Document node.
-
useCapture If
true, the specifiedlisteneris to be invoked only during the capturing phase of event propagation. The more common value offalsemeans that thelistenerwill not be invoked during the capturing phase but instead will be invoked when this node is the actual event target or when the event bubbles up to this node from its original target.
Description
This method adds the specified event listener function to the set of
listeners registered on this node to handle events of the specified
type. If
useCapture is true, the
listener is registered as a capturing event listener. If
useCapture is false, it
is registered as a normal event listener.
addEventListener( ) may be called multiple times
to register multiple event handlers for the same type of event on the
same node. Note, however, that the DOM makes no guarantees about the
order in which multiple event handlers will be invoked.
If the same event listener function is registered twice on the same
node with the same type and
useCapture arguments, the second registration is simply ignored. ...