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 specifiedlistener
is to be invoked only during the capturing phase of event propagation. The more common value offalse
means that thelistener
will 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. ...
Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.