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

CKTIS / JavaScript

ResizeObserverEntry: elemento observado y rectángulo de contenido

Usa `target` para identificar a qué elemento corresponde la entrada y `contentRect` para leer las dimensiones notificadas, sin relleno ni bordes en un elemento HTML.

Versión: Current web platform; runtime support varies

Sintaxis

entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.height

Durante el renderizado, el navegador pasa un array de entradas ResizeObserverEntry a la función de retrollamada de ResizeObserver. La propiedad entry.target es de solo lectura y referencia el elemento observado, no una copia. Si observas varios elementos, compara target con una referencia conocida mediante ===.

entry.contentRect es un objeto DOMRectReadOnly que conserva la medición de la notificación y no se actualiza en tiempo real. Para un elemento HTML, width y height son el ancho y el alto físicos de la caja de contenido en píxeles CSS, sin relleno ni bordes. Para un elemento gráfico SVG sin caja de disposición CSS, la medición describe su rectángulo delimitador. No lo confundas con getBoundingClientRect(), que en HTML devuelve un rectángulo que abarca las cajas de borde en relación con el área visible del navegador.

contentRect se conserva por compatibilidad con versiones anteriores. Para obtener dimensiones lógicas, usa contentBoxSize cuando esté disponible: inlineSize y blockSize siguen el modo de escritura. La opción box de observe() determina qué caja debe cambiar para activar las notificaciones; elegir border-box no convierte contentRect en una medición de la caja de borde. ECMAScript 2024 indica únicamente la versión de referencia del lenguaje JavaScript. Ambas propiedades se definen en la especificación de Resize Observer, no en ECMAScript, y su disponibilidad depende del entorno de ejecución.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ResizeObserverEntry example</title>
</head>
<body>
<script>
(() => {
  const box = document.createElement('div');
  Object.assign(box.style, {
    boxSizing: 'content-box',
    width: '120px',
    height: '60px',
    padding: '10px',
    border: '2px solid black'
  });
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    const { width, height } = entry.contentRect;
    console.log(`${entry.target === box}: ${width} × ${height} CSS px`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box);
})();
</script>
</body>
</html>

Resultado

true: 120 × 60 CSS px

Guarda el ejemplo como archivo `.html` y ábrelo en un navegador compatible con `ResizeObserver`. Abre la consola de desarrollo y recarga la página. La notificación inicial muestra `true: 120 × 60 CSS px`: `true` confirma la identidad del elemento y las dimensiones excluyen el relleno y los bordes. Después, el código deja de observar y elimina el elemento.

Lecciones relacionadas

  • JavaScript · Lección 32 · Intermedio · Versión: 3

Fuentes