CKTIS / JavaScript
Evento `resize` de `Window`
Escucha `resize` en `window` para reaccionar a cambios en el tamaño del área de visualización de diseño. Usa `ResizeObserver` para seguir el tamaño de un elemento concreto.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
window.addEventListener("resize", handler);
window.removeEventListener("resize", handler);
// Alternative: assign a single handler property.
window.onresize = handler;
window.onresize = null;El navegador dispara resize en window cuando cambia el tamaño del área de visualización que utiliza para calcular el diseño de la página (layout viewport). Es una API de la plataforma web, no parte de ECMAScript. El navegador entrega un Event genérico que no contiene las nuevas dimensiones. El evento no se propaga por burbujeo y no se puede cancelar con preventDefault().
Lee la anchura y la altura actuales con window.innerWidth y window.innerHeight. Los valores están en píxeles CSS e incluyen, respectivamente, la anchura de la barra de desplazamiento vertical y la altura de la horizontal, si están presentes. Si tu aplicación necesita las dimensiones de inmediato, llama a la función de actualización al inicializarla: registrar el listener no la llama. Durante el cambio de tamaño, el evento puede dispararse varias veces; evita operaciones costosas en cada llamada.
addEventListener("resize", handler) permite registrar varios listeners distintos. Cuando ya no necesites uno, retíralo con removeEventListener() usando el mismo tipo de evento, la misma referencia a la función y el mismo valor de capture. Asignar a window.onresize solo reemplaza el manejador de esa propiedad, no los listeners registrados con addEventListener(); asignar null quita ese manejador.
Usa ResizeObserver para observar un elemento: su tamaño puede cambiar sin que cambie el área de visualización de diseño. Para seguir el tamaño de la parte visible de la página, escucha el evento independiente resize en window.visualViewport si esa API está disponible.
Ejemplos
{
const target = typeof window === "undefined" ? new EventTarget() : window;
function reportResize(event) {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
}
target.addEventListener("resize", reportResize);
target.dispatchEvent(new Event("resize"));
target.removeEventListener("resize", reportResize);
target.dispatchEvent(new Event("resize"));
}Resultado
resize: bubbles=false, cancelable=false
Ejecuta el código en la consola del navegador o con Node.js 24. En el navegador, el código usa `window`; en Node.js, usa un objeto `EventTarget` independiente. El primer evento sintético llama al listener de forma síncrona y muestra una línea. El segundo se dispara después de retirar el listener, así que el código no muestra nada más. Ninguno de los dos cambia el tamaño del área de visualización.
Lecciones relacionadas
- JavaScript · Lección 27 · Intermedio · Versión: 3