KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ResizeObserverEntry: geobserveerd element en inhoudsrechthoek

Gebruik `target` om te bepalen op welk element de vermelding betrekking heeft en `contentRect` om de gemelde afmetingen te lezen, bij HTML zonder opvulling en randen.

Versie: Current web platform; runtime support varies

Syntax

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

Tijdens het renderen geeft de browser de callback van ResizeObserver een array met ResizeObserverEntry-vermeldingen. De alleen-lezen eigenschap entry.target verwijst naar het geobserveerde element zelf, niet naar een kopie. Als je meerdere elementen observeert, vergelijk je target met een bekende elementreferentie via ===.

entry.contentRect is een DOMRectReadOnly met de meting uit de melding; die wordt niet voortdurend bijgewerkt. Bij een HTML-element zijn width en height de fysieke breedte en hoogte van het inhoudsvak in CSS-pixels, zonder opvulling of randen. Bij een grafisch SVG-element zonder CSS-layoutvak beschrijft de meting de begrenzingsrechthoek. Verwar dit niet met getBoundingClientRect(): die methode geeft voor HTML een rechthoek om de randvakken, relatief aan de viewport.

contentRect blijft beschikbaar voor achterwaartse compatibiliteit. Gebruik voor logische afmetingen contentBoxSize waar dit wordt ondersteund: inlineSize en blockSize volgen de schrijfmodus. De optie box van observe() bepaalt welk vak moet veranderen om meldingen te activeren; met border-box gaat contentRect niet ineens het randvak meten. ECMAScript 2024 geeft hier alleen aan welke versie van de JavaScript-taal als uitgangspunt dient. Beide eigenschappen zijn gedefinieerd in de Resize Observer-specificatie, niet in ECMAScript. Hun beschikbaarheid hangt af van de uitvoeringsomgeving.

Voorbeelden

<!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>

Resultaat

true: 120 × 60 CSS px

Sla het voorbeeld op als `.html`-bestand en open het in een browser die `ResizeObserver` ondersteunt. Open de ontwikkelaarsconsole en laad de pagina opnieuw. De eerste melding schrijft `true: 120 × 60 CSS px`: `true` bevestigt dat het om hetzelfde element gaat, en de afmetingen zijn zonder opvulling en randen. Daarna stopt de code de observatie en verwijdert het element.

Gerelateerde lessen

  • JavaScript · Les 32 · Gemiddeld · Versie: 3

Bronnen