KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ResizeObserverEntry — het geobserveerde element en de afmetingen

ResizeObserverEntry beschrijft één element in een ResizeObserver-melding. De eigenschap target verwijst naar het element en contentRect geeft de afmetingen ervan. Leer het verschil tussen het inhoudsvak van een HTML-element en het begrenzingsvak van een SVG.

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

Syntax

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

ResizeObserverEntry is een record dat in de array entries aan de callback van een ResizeObserver wordt meegegeven. Eén aanroep kan records voor meerdere geobserveerde elementen opleveren. Verwerk daarom de array in plaats van ervan uit te gaan dat er maar één resultaat in staat.

ResizeObserverEntry.target is een alleen-lezen eigenschap die verwijst naar het geobserveerde Element of SVGElement. Zo kan een meting aan het juiste element worden gekoppeld. De verwijzing zelf is alleen-lezen, maar het element waarnaar wordt verwezen kan nog steeds worden aangepast.

ResizeObserverEntry.contentRect is een alleen-lezen eigenschap die een DOMRectReadOnly teruggeeft. Voor een HTML-element beschrijft deze het inhoudsvak, zonder padding en randen. Voor een grafisch SVG-element zonder bijbehorend CSS-layoutvak beschrijft deze het begrenzingsvak van dat element. Bij een buitenste <svg>-element met een CSS-layoutvak kan de eigenschap in plaats daarvan het CSS-inhoudsvak van dat element beschrijven. width en height zijn afmetingen, niet de buitenmaat van het HTML-element. Deze oudere eigenschap is behouden voor compatibiliteit; nieuwere eigenschappen zoals contentBoxSize en borderBoxSize hebben afzonderlijke ondersteuningseisen.

Dit is een Web API-interface, geen functie van een bepaalde ECMAScript-editie. MDN vermeldt dat de basisondersteuning sinds juli 2020 algemeen beschikbaar is; de beschikbaarheid van aanvullende eigenschappen kan verschillen. Node 24 toont geen browserondersteuning aan. Meldingen zijn asynchroon. Vermijd groottewijzigingen in de callback die eindeloos nieuwe meldingen veroorzaken.

Voorbeelden

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

Resultaat

resize-demo: 120 x 60

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen