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

CKTIS / JavaScript

ResizeObserver — observar o tamanho de um elemento

ResizeObserver comunica os tamanhos dos elementos mesmo quando a janela não muda de tamanho. Permite que um componente responda ao espaço disponível sem consultar repetidamente o DOM.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();

ResizeObserver é uma API do navegador, não uma funcionalidade ECMAScript; Node 24 não confirma a sua disponibilidade. O evento resize é disparado no objeto Window quando a janela muda de tamanho, ao passo que ResizeObserver notifica alterações no tamanho de um elemento observado. As notificações são assíncronas e agrupadas durante a apresentação.

observe() observa content-box por predefinição. border-box inclui o preenchimento e as bordas, enquanto device-pixel-content-box mede o conteúdo em píxeis inteiros do dispositivo. A opção box seleciona o acionador; não filtra os campos do resultado.

O callback recebe entries e o observador. Uma entrada contém target, contentRect e matrizes de tamanhos como contentBoxSize; os respetivos inlineSize e blockSize dependem do modo de escrita. contentRect.width e contentRect.height descrevem as dimensões físicas do conteúdo.

Evite alterações de tamanho no callback que criem ciclos de retroação: o navegador pode comunicar um erro de ciclo de observação de redimensionamento. As transformações CSS, por si só, não acionam notificações. unobserve(element) termina uma observação; disconnect() termina todas. Verifique a disponibilidade da API e das opções necessárias nos navegadores de destino.

Exemplos

(() => {
  if (typeof ResizeObserver !== "function") {
    throw new Error("ResizeObserver unavailable");
  }

  const box = document.createElement("div");
  box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box, { box: "content-box" });
})();

Resultado

120 x 40

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes