CKTIS / JavaScript
ResizeObserverEntry — o elemento observado e o respetivo tamanho
ResizeObserverEntry descreve um elemento numa notificação de ResizeObserver. A propriedade target identifica o elemento, enquanto contentRect fornece as respetivas dimensões. Saiba distinguir a caixa de conteúdo de um elemento HTML da caixa delimitadora de um SVG.
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
new ResizeObserver((entries) => {
for (const entry of entries) {
const element = entry.target;
const { width, height } = entry.contentRect;
}
}).observe(element);ResizeObserverEntry é um registo fornecido no array entries à função de callback de um ResizeObserver. Uma chamada pode fornecer registos de vários elementos observados; por isso, percorra o array em vez de presumir que contém apenas um resultado.
ResizeObserverEntry.target é uma propriedade só de leitura que referencia o Element ou SVGElement observado. Permite associar uma medição ao elemento correto. A referência em si é só de leitura, mas o elemento referenciado continua a poder ser modificado.
ResizeObserverEntry.contentRect é uma propriedade só de leitura que devolve um DOMRectReadOnly. Para um elemento HTML, descreve a caixa de conteúdo, excluindo o preenchimento e as bordas. Para um elemento gráfico SVG sem uma caixa de disposição CSS associada, descreve a respetiva caixa delimitadora. Se um elemento <svg> exterior tiver uma caixa de disposição CSS, a propriedade pode, em vez disso, descrever a caixa de conteúdo CSS do elemento. width e height são dimensões, não o tamanho exterior do elemento HTML. Esta propriedade antiga é mantida por compatibilidade; propriedades mais recentes, como contentBoxSize e borderBoxSize, têm requisitos de suporte próprios.
Esta é uma interface de Web API, não uma funcionalidade de uma edição específica de ECMAScript. A MDN indica que o suporte básico está amplamente disponível desde julho de 2020; a disponibilidade de propriedades adicionais pode variar. O Node 24 não comprova o suporte nos navegadores. As notificações são assíncronas. Evite alterações de tamanho no callback que desencadeiem notificações sucessivas sem fim.
Exemplos
(() => {
if (typeof ResizeObserver === "undefined") {
throw new Error("ResizeObserver is not supported");
}
const box = document.createElement("div");
box.id = "resize-demo";
box.style.cssText = "display: block; box-sizing: content-box; width: 120px; height: 60px; padding: 10px; border: 2px solid black;";
document.body.append(box);
const observer = new ResizeObserver((entries) => {
for (const entry of entries) {
const { width, height } = entry.contentRect;
console.log(`${entry.target.id}: ${width} x ${height}`);
}
observer.disconnect();
box.remove();
});
observer.observe(box);
})();Resultado
resize-demo: 120 x 60
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.