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

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.

Fontes