CKTIS / JavaScript
ResizeObserverEntry: sledovaný prvok a obdĺžnik obsahu
Pomocou `target` zistíš, ku ktorému prvku záznam patrí, a z `contentRect` prečítaš oznámené rozmery, pri prvku HTML bez vnútorného odsadenia a orámovania.
Verzia: Current web platform; runtime support varies
Syntax
entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.heightPri vykresľovaní prehliadač odovzdá funkcii spätného volania ResizeObserver pole záznamov ResizeObserverEntry. Vlastnosť entry.target je len na čítanie a odkazuje na samotný sledovaný prvok, nie na jeho kópiu. Ak sleduješ viac prvkov, porovnaj target so známou referenciou na prvok pomocou ===.
entry.contentRect je objekt DOMRectReadOnly s meraním z okamihu oznámenia, nie priebežne aktualizovaný údaj. Pri prvku HTML udávajú width a height fyzickú šírku a výšku oblasti obsahu v pixeloch CSS, bez vnútorného odsadenia a orámovania. Pri grafickom prvku SVG bez oblasti rozloženia CSS meranie opisuje jeho ohraničujúci obdĺžnik. Nezamieňaj si ho s výsledkom getBoundingClientRect(), ktorý pri HTML vracia obdĺžnik zahŕňajúci oblasti vrátane orámovania vzhľadom na oblasť zobrazenia prehliadača.
contentRect je zachovaná kvôli spätnej kompatibilite. Na logické rozmery použi contentBoxSize, ak je podporovaná: inlineSize a blockSize sa riadia režimom písania. Voľba box v metóde observe() určuje, zmeny ktorej oblasti vyvolávajú oznámenia. Nastavenie border-box nespôsobí, že contentRect bude merať oblasť vrátane orámovania. ECMAScript 2024 tu označuje len východiskovú verziu jazyka JavaScript. Obe vlastnosti definuje špecifikácia Resize Observer, nie ECMAScript; ich dostupnosť závisí od prostredia vykonávania.
Príklady
<!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>Výsledok
true: 120 × 60 CSS px
Ulož príklad ako súbor `.html` a otvor ho v prehliadači s podporou `ResizeObserver`. Otvor vývojársku konzolu a znova načítaj stránku. Prvé oznámenie vypíše `true: 120 × 60 CSS px`: `true` potvrdzuje, že ide o ten istý prvok, a rozmery nezahŕňajú vnútorné odsadenie ani orámovanie. Kód potom ukončí sledovanie a odstráni prvok.
Súvisiace lekcie
- JavaScript · Lekcia 32 · Stredne pokročilá · Verzia: 3