Saltar al contenido
JavaScript en el navegador

Eventos

Lección 3 de 1413 min4 ejercicios

Un clic, una tecla, el scroll, el envío de un formulario: todo lo que pasa en una página es un evento. Tu código se suscribe con addEventListener y el navegador lo llama cuando ocurre, a través del event loop. Entender cómo viaja un evento por el árbol es la clave para escribir menos código y con menos errores.

Qué mirar en el pizarrón

Las tarjetas son el camino del evento, de window al botón. Fíjate en en qué fase corre cada listener: bajando (captura), en el objetivo y subiendo (burbujeo).

En el pizarrón

<ul id="lista">  <li id="item">    <button id="boton">Borrar</button>  </li></ul> <script>  lista.addEventListener("click", () => console.log("ul, captura"), { capture: true });  boton.addEventListener("click", () => console.log("button"));  item.addEventListener("click", () => console.log("li"));  lista.addEventListener("click", () => console.log("ul"));</script>

Variables

  1. window
  2. document
  3. <ul id="lista">
  4. <li id="item">
  5. <button id="boton">¡clic aquí!
Consola(vacía)

El usuario hace clic en el botón. El evento no ocurre solo en el botón: va a recorrer todo el camino desde window hasta él, y de vuelta.

Con el foco aquí también puedes avanzar y retroceder con las flechas del teclado.

Ver todos los pasos en texto
  1. Paso 1: El usuario hace clic en el botón. El evento no ocurre solo en el botón: va a recorrer todo el camino desde window hasta él, y de vuelta. Variables: window, document, <ul id="lista">, <li id="item">, <button id="boton"> ¡clic aquí!.
  2. Paso 2: Fase de captura: el evento baja desde window. Solo se ejecutan los listeners con capture: true, como el del ul. Variables: window captura ↓, document captura ↓, <ul id="lista"> captura ↓ · listener, <li id="item">, <button id="boton">.
  3. Paso 3: El evento llega al objetivo, el elemento donde ocurrió: e.target. Se ejecutan sus listeners. Variables: window, document, <ul id="lista">, <li id="item">, <button id="boton"> objetivo · listener.
  4. Paso 4: Fase de burbujeo: el evento sube por los ancestros y ejecuta sus listeners normales. Primero el li… Variables: window, document, <ul id="lista">, <li id="item"> burbujeo ↑ · listener, <button id="boton">.
  5. Paso 5: …después el ul. Dentro de este listener, e.target sigue siendo el botón, y e.currentTarget es el ul. Variables: window, document, <ul id="lista"> burbujeo ↑ · listener, <li id="item">, <button id="boton">.
  6. Paso 6: El evento sigue subiendo hasta document y window. Esto permite la delegación: un solo listener en un contenedor atiende los clics de todos sus hijos, incluso de los que se agreguen después. Variables: window burbujeo ↑, document burbujeo ↑, <ul id="lista">, <li id="item">, <button id="boton">.

Escuchar un evento

document.body.innerHTML = `<button id="contar">Clics: 0</button>`;
const boton = document.querySelector("#contar");
let clics = 0;

boton.addEventListener("click", (e) => {
  clics++;
  boton.textContent = `Clics: ${clics}`;
  console.log(e.type, e.target.tagName);
});

boton.click();   // simula un clic desde el código
boton.click();

El listener recibe un objeto evento con información: type, target (dónde ocurrió), la tecla en un evento de teclado (e.key), la posición en uno de ratón (e.clientX)… Algunos eventos comunes: click, input, change, submit, keydown, pointerdown, focus, scroll.

Para dejar de escuchar, removeEventListener necesita la misma función, así que guárdala en una variable.

Captura y burbujeo

Como muestra el pizarrón, un evento recorre el árbol en tres fases: captura (bajando desde window), el objetivo y burbujeo (subiendo). Por defecto, los listeners corren en el burbujeo.

Dentro del listener:

  • e.target es el elemento donde ocurrió el evento, que puede ser un hijo.
  • e.currentTarget es el elemento cuyo listener se está ejecutando.
  • e.stopPropagation() detiene el viaje: los ancestros no se enteran. Úsalo poco: rompe la delegación y otros listeners que dependen del burbujeo.

Acciones por defecto

Muchos eventos tienen una acción del navegador: un enlace navega, un formulario se envía, un checkbox se marca. e.preventDefault() la cancela:

document.body.innerHTML = `<a id="enlace" href="https://ejemplo.com">Ir</a>`;

document.querySelector("#enlace").addEventListener("click", (e) => {
  e.preventDefault();
  console.log("no navego; muestro una vista previa");
});

document.querySelector("#enlace").click();

Delegación

En lugar de un listener por cada elemento, uno solo en el contenedor: el burbujeo trae los eventos de todos los hijos, incluso de los que se agreguen después.

document.body.innerHTML = `
  <ul id="colores">
    <li data-color="rojo">Rojo</li>
    <li data-color="azul">Azul</li>
  </ul>`;
const lista = document.querySelector("#colores");

lista.addEventListener("click", (e) => {
  const li = e.target.closest("li");
  if (!li) return;                       // el clic no fue en un li
  console.log("elegiste", li.dataset.color);
});

const verde = document.createElement("li");
verde.dataset.color = "verde";
verde.textContent = "Verde";
lista.append(verde);                     // agregado después: también funciona

lista.querySelectorAll("li").forEach((li) => li.click());

closest es la pieza clave: sube desde e.target hasta encontrar el elemento que te interesa, así que funciona aunque el clic caiga en un ícono o un texto dentro.

Opciones de addEventListener

document.body.innerHTML = `<button id="unaVez">Solo una vez</button>`;
const boton = document.querySelector("#unaVez");
const control = new AbortController();

boton.addEventListener("click", () => console.log("primera y única"), { once: true });
boton.addEventListener("click", () => console.log("hasta que se cancele"), { signal: control.signal });

boton.click();
control.abort();   // quita el segundo listener
boton.click();
  • once: true: el listener se quita solo después de la primera vez.
  • signal: el listener se quita cuando se cancela la señal. Con un solo abort() quitas muchos listeners a la vez.
  • passive: true: prometes no llamar a preventDefault; el navegador puede hacer scroll sin esperar a tu código.
  • capture: true: el listener corre en la fase de captura.

Resumen

  • addEventListener(tipo, fn, opciones) suscribe; el listener recibe el objeto evento.
  • Tres fases: captura, objetivo y burbujeo; por defecto se escucha en el burbujeo.
  • e.target es donde ocurrió; e.currentTarget, de quién es el listener.
  • preventDefault() cancela la acción del navegador; stopPropagation(), el viaje.
  • Delegación: un listener en el contenedor y e.target.closest(…).
  • Opciones: once, signal, passive y capture.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Reaccionar a lo que pasa

Elige una respuesta en cada pregunta.

  1. Un clic en un botón dentro de un <li>, ¿qué listeners de click se ejecutan?

  2. ¿Qué diferencia hay entre e.target y e.currentTarget?

  3. ¿Qué es la delegación de eventos?

  4. ¿Qué hace e.preventDefault()?

Ordena la salida: Captura y burbujeo

Cuatro listeners y un clic en el botón. Ordena lo que aparecería en la consola.

document.body.innerHTML = `<div id="tarjeta"><button id="me-gusta">❤</button></div>`;const tarjeta = document.querySelector("#tarjeta");const boton = document.querySelector("#me-gusta"); document.addEventListener("click", () => console.log("document"));tarjeta.addEventListener("click", () => console.log("tarjeta"));tarjeta.addEventListener("click", () => console.log("tarjeta, en captura"), { capture: true });boton.addEventListener("click", () => console.log("botón")); boton.click();

Consola, de arriba abajo

  1. tarjeta
  2. tarjeta, en captura
  3. document
  4. botón

Detective: Un clic en el ícono

El botón funciona… a veces. Encuentra la línea que falla al hacer clic en el ícono y elige el arreglo.

Consola

Uncaught TypeError: Cannot read properties of undefined (reading 'toUpperCase')
    at HTMLButtonElement.<anonymous> (index.html:7:52)

Paso 1: toca la línea de código que causa el error.

Laboratorio: Borrar con un solo listener

Haz que los botones “Borrar” funcionen con delegación: un solo listener en la lista. Puedes probarlo con clics en la página de abajo.

app.jsse ejecuta mientras escribes

La página index.html

Consola del navegador

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Al hacer clic en el segundo "Borrar", desaparece la leche (pendiente)
  • Funciona con los elementos agregados después (pendiente)
  • Usa un solo listener en la lista (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.