Parámetro | Descripción |
---|---|
tipo | String define el nombre del evento a escuchar. |
oyente | Function dispara cuando ocurre el evento. |
opciones | Boolean para establecer la captura, si Object puede establecer las siguientes propiedades en él, observe que la opción de objeto es débilmente compatible. |
1. captura | Un valor booleano que indica que los eventos de este tipo se enviarán al oyente registrado antes de enviarse a cualquier EventTarget debajo de él en el árbol DOM. |
2. una vez | Un valor booleano que indica que el oyente debe invocarse a lo sumo una vez después de agregarse. Si es verdad, el oyente se eliminaría automáticamente cuando se invoca. |
3. pasivo | Un valor booleano que indica que el oyente nunca llamará a preventDefault (). Si lo hace, el agente de usuario debe ignorarlo y generar una advertencia de consola. |
Los eventos no comienzan con lo que activó el evento (por ejemplo, un botón).
Toca cada elemento en su camino e informa a cada elemento que un evento está sucediendo. Los eventos también regresan una vez que llegan a su destino, informando nuevamente a los elementos de su ocurrencia.
Como aprendimos, los eventos comienzan desde la parte superior del árbol DOM, informan a cada nodo en su camino hacia su destino, luego regresan cuando llega a su destino, e informan a cada elemento que toca sobre su ocurrencia.
Los eventos que pasan por el árbol DOM están en la fase de captura , los eventos que suben por el árbol DOM están en la fase de propagación .
Por defecto, los eventos se escuchan en la fase de propagación. Para cambiar esto, puede especificar en qué fase se escucha el evento especificando el tercer parámetro en la función addEventListener. (Ejemplo de código en la sección de captura )