KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ResizeObserver.observe — de grootte van een element observeren

ResizeObserver.observe registreert een element voor asynchrone meldingen over de grootte. De optie box kiest het geobserveerde gebied.

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

observer.observe(target, { box: "content-box" });

observer.observe(target, options) accepteert een Element en retourneert undefined. Meldingen bereiken de callback van de observer tijdens het renderen, niet synchroon.

box is standaard "content-box" (inhoud); "border-box" omvat ook padding en randen, terwijl "device-pixel-content-box" de inhoud meet in gehele apparaatpixels. Deze keuze bepaalt wanneer meldingen worden geactiveerd, niet welke velden beschikbaar zijn in de entry. CSS-transformaties activeren geen observaties.

Nogmaals observe aanroepen voor hetzelfde element met dezelfde waarde voor box heeft in Chromium geen effect. Ga er niet van uit dat zo’n aanroep in elke browser de registratie vervangt of de meldingsstatus ervan terugzet. unobserve(target) verwijdert er één; disconnect() verwijdert ze allemaal. Vermijd cyclische grootteveranderingen in de callback. Dit is een Web-API, geen ECMAScript-functie; Node 24 bewijst geen browserondersteuning.

Voorbeelden

const target = document.createElement("div");
target.style.cssText = "all: initial; display: block; width: 120px; height: 40px;";
document.body.append(target);

const observer = new ResizeObserver(([entry]) => {
  console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
  observer.disconnect();
  target.remove();
});
observer.observe(target, { 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