CKTIS / JavaScript
ResizeObserverEntry: beobachtetes Element und Inhaltsrechteck
Mit `target` erkennst du, zu welchem Element ein Eintrag gehört. `contentRect` liefert dessen gemeldete Maße, bei HTML-Elementen ohne Innenabstand und Rahmen.
Version: Current web platform; runtime support varies
Syntax
entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.heightBeim Rendern übergibt der Browser dem Callback von ResizeObserver ein Array mit ResizeObserverEntry-Einträgen. Die schreibgeschützte Eigenschaft entry.target verweist auf das tatsächlich beobachtete Element, nicht auf eine Kopie. Wenn du mehrere Elemente beobachtest, vergleiche target mit einer bekannten Elementreferenz über ===.
entry.contentRect ist eine Momentaufnahme vom Zeitpunkt der Benachrichtigung als DOMRectReadOnly; sie wird nicht laufend aktualisiert. Bei einem HTML-Element geben width und height die physische Breite und Höhe der Inhaltsbox in CSS-Pixeln an, ohne Innenabstand und Rahmen. Bei einer SVG-Grafik ohne CSS-Layoutbox beschreibt die Messung deren Begrenzungsrechteck. Verwechsle das nicht mit getBoundingClientRect(): Bei HTML liefert diese Methode ein Rechteck um die Rahmenboxen relativ zum Ansichtsbereich.
contentRect bleibt aus Gründen der Abwärtskompatibilität erhalten. Für logische Größen verwende, sofern unterstützt, contentBoxSize: inlineSize und blockSize richten sich nach dem Schreibmodus. Die Option box von observe() legt fest, Änderungen welcher Box Benachrichtigungen auslösen. Mit border-box wird contentRect nicht zum Maß der Rahmenbox. ECMAScript 2024 bezeichnet hier nur die zugrunde gelegte JavaScript-Sprachversion. Beide Eigenschaften sind in der Resize-Observer-Spezifikation definiert, nicht in ECMAScript. Ihre Verfügbarkeit hängt von der Laufzeitumgebung ab.
Beispiele
<!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>Ergebnis
true: 120 × 60 CSS px
Speichere das Beispiel als `.html`-Datei und öffne es in einem Browser, der `ResizeObserver` unterstützt. Öffne die Entwicklerkonsole und lade die Seite neu. Die erste Benachrichtigung gibt `true: 120 × 60 CSS px` aus: `true` bestätigt die Identität des Elements; die Maße enthalten weder Innenabstand noch Rahmen. Danach beendet der Code die Beobachtung und entfernt das Element.
Zugehörige Lektionen
- JavaScript · Lektion 32 · Mittlere Stufe · Version: 3