CKTIS / JavaScript
ResizeObserverEntry — obserwowany element i jego rozmiar
ResizeObserverEntry opisuje pojedynczy element w powiadomieniu ResizeObserver. Właściwość target wskazuje element, a contentRect udostępnia jego wymiary. Poznaj różnicę między obszarem treści HTML a prostokątem ograniczającym SVG.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new ResizeObserver((entries) => {
for (const entry of entries) {
const element = entry.target;
const { width, height } = entry.contentRect;
}
}).observe(element);ResizeObserverEntry to rekord przekazywany w tablicy entries do funkcji zwrotnej ResizeObserver. Jedno wywołanie może dostarczyć rekordy dla kilku obserwowanych elementów, dlatego należy przetwarzać tablicę, a nie zakładać, że zawiera tylko jeden wynik.
ResizeObserverEntry.target jest właściwością tylko do odczytu: wskazuje obserwowany Element lub SVGElement. Pozwala powiązać pomiar z właściwym elementem. Samo odwołanie jest tylko do odczytu, ale wskazany element nadal można modyfikować.
ResizeObserverEntry.contentRect jest właściwością tylko do odczytu zwracającą DOMRectReadOnly. Dla elementu HTML opisuje obszar treści, bez paddingu i obramowania. Dla elementu graficznego SVG, który nie ma powiązanej ramki układu CSS, opisuje jego prostokąt ograniczający. Jeśli zewnętrzny element <svg> ma ramkę układu CSS, właściwość może zamiast tego opisywać jego obszar treści CSS. width i height to wymiary, a nie rozmiar zewnętrzny elementu HTML. Jest to starsza właściwość zachowana dla zgodności; nowsze właściwości, takie jak contentBoxSize i borderBoxSize, mają osobne wymagania dotyczące obsługi.
To interfejs Web API, nie funkcja określonej edycji ECMAScript. MDN oznacza podstawową obsługę jako szeroko dostępną od lipca 2020; dostępność dodatkowych właściwości może się różnić. Node 24 nie dowodzi obsługi w przeglądarce. Powiadomienia są asynchroniczne. Unikaj zmian rozmiaru w funkcji zwrotnej, które bez końca wywołują kolejne powiadomienia.
Przykłady
(() => {
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);
})();Wynik
resize-demo: 120 x 60
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.