CKTIS / JavaScript
ResizeObserverEntry — das beobachtete Element und seine Größe
ResizeObserverEntry beschreibt ein einzelnes Element in einer ResizeObserver-Benachrichtigung. Die Eigenschaft target verweist auf das Element, während contentRect seine Abmessungen bereitstellt. Erfahre den Unterschied zwischen dem Inhaltsbereich eines HTML-Elements und dem Begrenzungsrechteck eines SVG-Elements.
Version: 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 ist ein Datensatz, der dem Callback eines ResizeObserver im Array entries übergeben wird. Ein Aufruf kann Datensätze für mehrere beobachtete Elemente liefern. Verarbeite daher das Array, statt anzunehmen, dass es nur ein Ergebnis enthält.
ResizeObserverEntry.target ist eine schreibgeschützte Eigenschaft, die auf das beobachtete Element oder SVGElement verweist. So lässt sich eine Messung dem richtigen Element zuordnen. Die Referenz selbst ist schreibgeschützt, das referenzierte Element kann jedoch weiterhin geändert werden.
ResizeObserverEntry.contentRect ist eine schreibgeschützte Eigenschaft, die ein DOMRectReadOnly zurückgibt. Bei einem HTML-Element beschreibt sie den Inhaltsbereich ohne Innenabstände und Rahmen. Bei einem SVG-Grafikelement ohne zugehörige CSS-Layoutbox beschreibt sie dessen Begrenzungsrechteck. Bei einem äußeren <svg>-Element mit CSS-Layoutbox kann sie stattdessen dessen CSS-Inhaltsbereich beschreiben. width und height sind Abmessungen, nicht die äußere Größe des HTML-Elements. Diese ältere Eigenschaft bleibt aus Kompatibilitätsgründen erhalten; neuere Eigenschaften wie contentBoxSize und borderBoxSize haben eigene Anforderungen an die Unterstützung.
Dies ist eine Web-API-Schnittstelle und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN kennzeichnet die grundlegende Unterstützung seit Juli 2020 als weit verbreitet; zusätzliche Eigenschaften können unterschiedlich verfügbar sein. Node 24 belegt keine Browserunterstützung. Benachrichtigungen erfolgen asynchron. Vermeide Größenänderungen im Callback, die endlos weitere Benachrichtigungen auslösen.
Beispiele
(() => {
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);
})();Ergebnis
resize-demo: 120 x 60
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.