Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ResizeObserverEntry: sledovaný prvek a obdélník obsahu

Pomocí `target` zjistíš, ke kterému prvku záznam patří, a z `contentRect` přečteš oznámené rozměry, u prvku HTML bez vnitřního odsazení a ohraničení.

Verze: Current web platform; runtime support varies

Syntaxe

entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.height

Při vykreslování předá prohlížeč zpětnému volání ResizeObserver pole záznamů ResizeObserverEntry. Vlastnost entry.target je jen pro čtení a odkazuje na samotný sledovaný prvek, nikoli na jeho kopii. Když sleduješ více prvků, porovnej target se známou referencí na prvek pomocí ===.

entry.contentRect je objekt DOMRectReadOnly s měřením z okamžiku oznámení, nikoli průběžně aktualizovaný údaj. U prvku HTML udávají width a height fyzickou šířku a výšku oblasti obsahu v pixelech CSS, bez vnitřního odsazení a ohraničení. U grafického prvku SVG bez oblasti rozvržení CSS měření popisuje jeho ohraničující obdélník. Nepleť si ho s výsledkem getBoundingClientRect(), který u HTML vrací obdélník obklopující oblasti včetně ohraničení vzhledem k výřezu prohlížeče.

contentRect je zachována kvůli zpětné kompatibilitě. Pro logické rozměry použij contentBoxSize, pokud je podporována: inlineSize a blockSize se řídí režimem zápisu. Volba box metody observe() určuje, změny které oblasti vyvolávají oznámení. Volba border-box nezpůsobí, že bude contentRect měřit oblast včetně ohraničení. ECMAScript 2024 zde označuje pouze výchozí verzi jazyka JavaScript. Obě vlastnosti definuje specifikace Resize Observer, nikoli ECMAScript; jejich dostupnost závisí na běhovém prostředí.

Pří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ýsledek

true: 120 × 60 CSS px

Ulož příklad jako soubor `.html` a otevři ho v prohlížeči s podporou `ResizeObserver`. Otevři vývojářskou konzoli a znovu načti stránku. První oznámení vypíše `true: 120 × 60 CSS px`: `true` potvrzuje, že jde o tentýž prvek, a rozměry nezahrnují vnitřní odsazení ani ohraničení. Kód pak ukončí sledování a prvek odstraní.

Související lekce

  • JavaScript · Lekce 32 · Středně pokročilá · Verze: 3

Zdroje