KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ResizeObserver — de grootte van een element observeren

ResizeObserver geeft de afmetingen van elementen door, ook wanneer het venster niet van grootte verandert. Zo kan een component reageren op de beschikbare ruimte zonder het DOM steeds opnieuw te bevragen.

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

const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();

ResizeObserver is een browser-API, geen ECMAScript-functie; Node 24 bevestigt niet dat deze beschikbaar is. De gebeurtenis resize wordt op Window geactiveerd wanneer het venster van grootte verandert, terwijl ResizeObserver veranderingen in de grootte van een geobserveerd element meldt. Meldingen zijn asynchroon en worden tijdens het renderen gebundeld.

observe() observeert standaard content-box. border-box omvat padding en randen, terwijl device-pixel-content-box de inhoud in gehele apparaatpixels meet. De optie box bepaalt de trigger en filtert niet de resultaatvelden.

De callback ontvangt entries en de observer. Een entry bevat target, contentRect en grootte-arrays zoals contentBoxSize; de waarden inlineSize en blockSize daarvan zijn afhankelijk van de schrijfrichting. contentRect.width en contentRect.height beschrijven de fysieke afmetingen van de inhoud.

Vermijd groottewijzigingen in de callback die feedbacklussen veroorzaken: de browser kan een fout over een resize-observatielus melden. CSS-transformaties alleen activeren geen meldingen. unobserve(element) beëindigt één observatie; disconnect() beëindigt ze allemaal. Controleer de beschikbaarheid van de API en de benodigde opties in de doelbrowsers.

Voorbeelden

(() => {
  if (typeof ResizeObserver !== "function") {
    throw new Error("ResizeObserver unavailable");
  }

  const box = document.createElement("div");
  box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box, { box: "content-box" });
})();

Resultaat

120 x 40

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