CKTIS / JavaScript
ResizeObserverEntry — pozorovaný prvek a jeho velikost
ResizeObserverEntry popisuje jeden prvek v oznámení ResizeObserver. Jeho vlastnost target určuje prvek, zatímco contentRect poskytuje jeho rozměry. Seznamte se s rozdílem mezi obsahem HTML prvku a ohraničujícím obdélníkem SVG.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new ResizeObserver((entries) => {
for (const entry of entries) {
const element = entry.target;
const { width, height } = entry.contentRect;
}
}).observe(element);ResizeObserverEntry je záznam předaný v poli entries callbacku ResizeObserver. Jedno volání může dodat záznamy pro několik pozorovaných prvků, proto zpracujte celé pole a nepředpokládejte, že obsahuje jen jeden výsledek.
ResizeObserverEntry.target je vlastnost pouze pro čtení, která odkazuje na pozorovaný Element nebo SVGElement. Umožňuje přiřadit měření ke správnému prvku. Samotný odkaz je pouze pro čtení, ale odkazovaný prvek lze stále upravovat.
ResizeObserverEntry.contentRect je vlastnost pouze pro čtení, která vrací DOMRectReadOnly. U HTML prvku popisuje obsahový rámeček bez vnitřních okrajů a ohraničení. U grafického prvku SVG, který nemá přiřazený rámeček rozvržení CSS, popisuje jeho ohraničující obdélník. U vnějšího prvku <svg> s rámečkem rozvržení CSS může místo toho popisovat jeho obsahový rámeček CSS. width a height jsou rozměry, nikoli vnější velikost HTML prvku. Tato starší vlastnost zůstává zachována kvůli kompatibilitě; novější vlastnosti, například contentBoxSize a borderBoxSize, mají samostatné požadavky na podporu.
Jde o rozhraní Web API, nikoli o funkci určité edice ECMAScriptu. MDN uvádí, že základní podpora je široce dostupná od července 2020; dostupnost dalších vlastností se může lišit. Node 24 nedokládá podporu v prohlížečích. Oznámení jsou asynchronní. Vyhněte se změnám velikosti v callbacku, které donekonečna vyvolávají další oznámení.
Příklady
(() => {
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);
})();Výsledek
resize-demo: 120 x 60
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.