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

CKTIS / JavaScript

ResizeObserver – opazovanje velikosti elementa

ResizeObserver sporoča velikosti elementov tudi takrat, ko se velikost okna ne spremeni. Komponenti omogoča, da se odzove na razpoložljivi prostor, ne da bi večkrat poizvedovala po DOM-u.

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

const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();

ResizeObserver je API brskalnika, ne funkcija ECMAScript; Node 24 ne potrjuje njegove razpoložljivosti. Dogodek resize se sproži na objektu Window, ko se spremeni velikost okna, ResizeObserver pa sporoča spremembe velikosti opazovanega elementa. Obvestila so asinhrona in se med izrisovanjem združujejo.

observe() privzeto opazuje content-box. border-box vključuje notranji odmik in obrobe, device-pixel-content-box pa meri vsebino v celih slikovnih pikah naprave. Možnost box izbere sprožilec, ne filtrira pa polj rezultata.

Povratni klic prejme entries in opazovalnik. Vnos vsebuje target, contentRect in polja velikosti, kot je contentBoxSize; vrednosti inlineSize in blockSize so odvisne od načina pisanja. contentRect.width in contentRect.height opisujeta fizične mere vsebine.

Izogibajte se spremembam velikosti v povratnem klicu, ki ustvarijo povratne zanke: brskalnik lahko sporoči napako zanke opazovanja spreminjanja velikosti. Same transformacije CSS ne sprožijo obvestil. unobserve(element) ustavi eno opazovanje, disconnect() pa vsa. Preverite razpoložljivost API-ja in potrebnih možnosti v ciljnih brskalnikih.

Primeri

(() => {
  if (typeof ResizeObserver !== "function") {
    throw new Error("ResizeObserver unavailable");
  }

  const box = document.createElement("div");
  box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box, { box: "content-box" });
})();

Rezultat

120 x 40

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

Viri