Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

ResizeObserverEntry — opazovani element in njegova velikost

ResizeObserverEntry opisuje en element v obvestilu ResizeObserver. Njegova lastnost target določa element, contentRect pa zagotavlja njegove mere. Spoznajte razliko med vsebinskim poljem elementa HTML in omejitvenim pravokotnikom SVG.

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

Sintaksa

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

ResizeObserverEntry je zapis, ki je funkciji povratnega klica ResizeObserver posredovan v polju entries. En klic lahko dostavi zapise za več opazovanih elementov, zato obdelajte polje, namesto da predpostavljate, da vsebuje samo en rezultat.

ResizeObserverEntry.target je lastnost samo za branje, ki kaže na opazovani Element ali SVGElement. Tako lahko meritev povežete s pravim elementom. Sklic je samo za branje, vendar lahko element, na katerega kaže, še vedno spreminjate.

ResizeObserverEntry.contentRect je lastnost samo za branje, ki vrne DOMRectReadOnly. Pri elementu HTML opisuje vsebinsko polje brez odmikov in obrob. Pri grafičnem elementu SVG brez pripadajočega postavitvenega okvirja CSS opisuje njegov omejitveni pravokotnik. Pri zunanjem elementu <svg> s postavitvenim okvirjem CSS pa lahko namesto tega opisuje njegovo vsebinsko polje CSS. width in height sta meri, ne zunanja velikost elementa HTML. Ta starejša lastnost je zaradi združljivosti ohranjena; novejše lastnosti, kot sta contentBoxSize in borderBoxSize, imajo ločene zahteve glede podpore.

To je vmesnik Web API, ne funkcija določene izdaje ECMAScript. MDN navaja, da je osnovna podpora široko dostopna od julija 2020; razpoložljivost dodatnih lastnosti se lahko razlikuje. Node 24 ne dokazuje podpore v brskalnikih. Obvestila so asinhrona. Izogibajte se spreminjanju velikosti v funkciji povratnega klica, če to neskončno sproža nova obvestila.

Primeri

(() => {
  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);
})();

Rezultat

resize-demo: 120 x 60

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri