Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

ResizeObserverEntry: el elemento observado y su tamaño

ResizeObserverEntry describe un elemento en una notificación de ResizeObserver. Su propiedad target identifica el elemento, mientras que contentRect proporciona sus dimensiones. Descubre la diferencia entre la caja de contenido de un elemento HTML y la caja delimitadora de un SVG.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

new ResizeObserver((entries) => {
  for (const entry of entries) {
    const element = entry.target;
    const { width, height } = entry.contentRect;
  }
}).observe(element);

ResizeObserverEntry es un registro que se proporciona en el array entries a la función de retorno de llamada de un ResizeObserver. Una invocación puede entregar registros de varios elementos observados, así que procesa el array en lugar de suponer que contiene un único resultado.

ResizeObserverEntry.target es una propiedad de solo lectura que hace referencia al Element o SVGElement observado. Permite asociar una medición con el elemento correcto. La referencia en sí es de solo lectura, pero el elemento al que apunta todavía se puede modificar.

ResizeObserverEntry.contentRect es una propiedad de solo lectura que devuelve un DOMRectReadOnly. Para un elemento HTML, describe la caja de contenido, sin relleno ni bordes. Para un elemento gráfico SVG sin una caja de diseño CSS asociada, describe su caja delimitadora. Si un elemento <svg> exterior tiene una caja de diseño CSS, la propiedad puede describir en su lugar la caja de contenido CSS del elemento. width y height son dimensiones, no el tamaño exterior del elemento HTML. Esta propiedad heredada se conserva por compatibilidad; las propiedades más recientes, como contentBoxSize y borderBoxSize, tienen requisitos de compatibilidad distintos.

Esta es una interfaz de Web API, no una característica de una edición concreta de ECMAScript. MDN indica que la compatibilidad básica está ampliamente disponible desde julio de 2020; la disponibilidad de propiedades adicionales puede variar. Node 24 no demuestra la compatibilidad con navegadores. Las notificaciones son asíncronas. Evita los cambios de tamaño en la función de retorno de llamada que desencadenan notificaciones posteriores sin fin.

Ejemplos

(() => {
  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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes