Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Evento `resize` de `Window`

Escuta `resize` em `window` para reagir a alterações nas dimensões da área de visualização usada na disposição da página. Usa `ResizeObserver` para acompanhar as dimensões de um elemento específico.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

window.addEventListener("resize", handler);
window.removeEventListener("resize", handler);

// Alternative: assign a single handler property.
window.onresize = handler;
window.onresize = null;

O navegador dispara resize em window quando mudam as dimensões da área de visualização usada para calcular a disposição da página (layout viewport). É uma API da plataforma Web, não faz parte de ECMAScript. O navegador fornece um Event genérico, sem as novas dimensões. O evento não se propaga por borbulhamento e não pode ser cancelado com preventDefault().

Lê a largura e a altura atuais em window.innerWidth e window.innerHeight. Os valores são em píxeis CSS e incluem, respetivamente, a largura da barra de deslocamento vertical e a altura da horizontal, se estiverem presentes. Se a aplicação precisar das dimensões logo no início, chama a função de atualização durante a inicialização: registar o ouvinte não chama a função. Durante o redimensionamento, o evento pode ocorrer várias vezes; evita operações dispendiosas em cada chamada.

addEventListener("resize", handler) permite registar vários ouvintes distintos. Quando já não precisares de um ouvinte, remove-o com removeEventListener(), usando o mesmo tipo de evento, a mesma referência à função e o mesmo valor de capture. Atribuir um valor a window.onresize substitui apenas a função definida nessa propriedade, não os ouvintes registados com addEventListener(); atribuir null remove essa função.

Usa ResizeObserver para observar um elemento: as dimensões do elemento podem mudar sem que mudem as da área de visualização usada na disposição da página. Para acompanhar as dimensões da parte visível da página, escuta o evento distinto resize em window.visualViewport, se essa API estiver disponível.

Exemplos

{
  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

Executa o código na consola do navegador ou com Node.js 24. No navegador, o código usa `window`; no Node.js, usa um objeto `EventTarget` independente. O primeiro evento sintético chama o ouvinte de forma síncrona e apresenta uma linha. O segundo é disparado depois de o ouvinte ser removido, pelo que o código não apresenta mais nada. Nenhum deles altera as dimensões da área de visualização.

Lições relacionadas

  • JavaScript · Lição 27 · Intermédio · Versão: 3

Fontes