Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ResizeObserverEntry — pozorovaný prvok a jeho veľkosť

ResizeObserverEntry opisuje jeden prvok v oznámení ResizeObserver. Jeho vlastnosť target určuje prvok, zatiaľ čo contentRect poskytuje jeho rozmery. Spoznajte rozdiel medzi obsahovou oblasťou prvku HTML a ohraničujúcim obdĺžnikom SVG.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new ResizeObserver((entries) => {
  for (const entry of entries) {
    const element = entry.target;
    const { width, height } = entry.contentRect;
  }
}).observe(element);

ResizeObserverEntry je záznam odovzdaný v poli entries callbacku ResizeObserver. Jedno volanie môže poskytnúť záznamy pre viacero pozorovaných prvkov, preto spracujte celé pole a nepredpokladajte, že obsahuje iba jeden výsledok.

ResizeObserverEntry.target je vlastnosť iba na čítanie, ktorá odkazuje na pozorovaný Element alebo SVGElement. Umožňuje priradiť meranie k správnemu prvku. Samotný odkaz je iba na čítanie, ale odkazovaný prvok možno naďalej upravovať.

ResizeObserverEntry.contentRect je vlastnosť iba na čítanie, ktorá vracia DOMRectReadOnly. Pri prvku HTML opisuje obsahový rámček bez vnútorných okrajov a orámovania. Pri grafickom prvku SVG, ktorý nemá priradený rámček rozloženia CSS, opisuje jeho ohraničujúci obdĺžnik. Pri vonkajšom prvku <svg> s rámčekom rozloženia CSS môže namiesto toho opisovať jeho obsahový rámček CSS. width a height sú rozmery, nie vonkajšia veľkosť prvku HTML. Táto staršia vlastnosť zostáva zachovaná kvôli kompatibilite; novšie vlastnosti, ako contentBoxSize a borderBoxSize, majú samostatné požiadavky na podporu.

Ide o rozhranie Web API, nie o funkciu konkrétneho vydania ECMAScriptu. MDN uvádza, že základná podpora je široko dostupná od júla 2020; dostupnosť ďalších vlastností sa môže líšiť. Node 24 nedokazuje podporu v prehliadačoch. Oznámenia sú asynchrónne. Vyhnite sa zmenám veľkosti v callbacku, ktoré donekonečna vyvolávajú ďalšie oznámenia.

Prí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ýsledok

resize-demo: 120 x 60

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje