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

CKTIS / JavaScript

Udalosť `resize` objektu `Window`

Pomocou udalosti `resize` na objekte `window` reaguj na zmenu veľkosti oblasti pre rozloženie stránky. Na sledovanie veľkosti konkrétneho prvku použi `ResizeObserver`.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

window.addEventListener("resize", handler);
window.removeEventListener("resize", handler);

// Alternative: assign a single handler property.
window.onresize = handler;
window.onresize = null;

Prehliadač vyvolá udalosť resize na objekte window, keď sa zmení veľkosť oblasti, podľa ktorej počíta rozloženie stránky (layout viewport). Ide o API webovej platformy, nie o súčasť ECMAScriptu. Prehliadač poskytne obyčajný objekt Event bez nových rozmerov. Udalosť sa nešíri bublaním a nedá sa zrušiť pomocou preventDefault().

Aktuálnu šírku a výšku načítaj z window.innerWidth a window.innerHeight. Hodnoty sú v pixeloch CSS a zahŕňajú šírku zvislého, respektíve výšku vodorovného posúvača, ak sú prítomné. Ak aplikácia potrebuje rozmery hneď, zavolaj aktualizačnú funkciu pri inicializácii: samotná registrácia poslucháča ju nezavolá. Pri zmene veľkosti sa môže udalosť opakovať, preto pri každom volaní nevykonávaj náročné operácie.

Pomocou addEventListener("resize", handler) môžeš zaregistrovať viacerých rôznych poslucháčov. Keď už poslucháča nepotrebuješ, odstráň ho pomocou removeEventListener() s rovnakým typom udalosti, rovnakým odkazom na funkciu a rovnakou hodnotou capture. Priradenie do window.onresize nahradí len obslužnú funkciu nastavenú touto vlastnosťou, nie poslucháčov pridaných cez addEventListener(); priradením null túto funkciu odstrániš.

Na sledovanie konkrétneho prvku použi ResizeObserver: jeho veľkosť sa môže zmeniť, aj keď veľkosť oblasti pre rozloženie zostane rovnaká. Na sledovanie veľkosti viditeľnej časti stránky počúvaj samostatnú udalosť resize na window.visualViewport, ak je toto API dostupné.

Príklady

{
  const target = typeof window === "undefined" ? new EventTarget() : window;

  function reportResize(event) {
    console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
  }

  target.addEventListener("resize", reportResize);
  target.dispatchEvent(new Event("resize"));
  target.removeEventListener("resize", reportResize);
  target.dispatchEvent(new Event("resize"));
}

Výsledok

resize: bubbles=false, cancelable=false

Spusť kód v konzole prehliadača alebo v Node.js 24. V prehliadači kód používa `window`, v Node.js samostatný objekt `EventTarget`. Prvá syntetická udalosť synchrónne zavolá poslucháča a vypíše jeden riadok. Druhá sa odošle po odstránení poslucháča, takže kód už nič nevypíše. Ani jedna udalosť nemení veľkosť zobrazovanej oblasti.

Súvisiace lekcie

  • JavaScript · Lekcia 27 · Stredne pokročilá · Verzia: 3

Zdroje