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.