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

CKTIS / JavaScript

Událost `resize` objektu `Window`

Poslouchej událost `resize` na objektu `window`, když chceš reagovat na změnu velikosti oblasti pro rozvržení stránky. Velikost konkrétního prvku sleduj pomocí `ResizeObserver`.

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

Syntaxe

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

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

Prohlížeč vyvolá událost resize na objektu window, když se změní velikost oblasti, podle níž počítá rozvržení stránky (layout viewport). Jde o API webové platformy, ne o součást ECMAScriptu. Prohlížeč předá obyčejný objekt Event bez nových rozměrů. Událost se nešíří bubláním a nelze ji zrušit pomocí preventDefault().

Aktuální šířku a výšku načti z window.innerWidth a window.innerHeight. Hodnoty jsou v pixelech CSS a zahrnují šířku svislého, respektive výšku vodorovného posuvníku, pokud jsou přítomné. Potřebuje-li aplikace rozměry hned, zavolej aktualizační funkci při inicializaci: samotná registrace posluchače ji nespustí. Při změně velikosti se může událost vyvolat opakovaně, proto při každém volání neprováděj náročné operace.

Pomocí addEventListener("resize", handler) můžeš registrovat více různých posluchačů. Nepotřebného posluchače odeber pomocí removeEventListener() se stejným typem události, stejnou referencí na funkci a stejnou hodnotou capture. Přiřazením do window.onresize nahradíš jen obslužnou funkci nastavenou touto vlastností, nikoli posluchače přidané přes addEventListener(); přiřazením null tuto funkci odebereš.

Pro sledování konkrétního prvku použij ResizeObserver: velikost prvku se může změnit, i když velikost oblasti pro rozvržení zůstane stejná. Chceš-li sledovat velikost viditelné části stránky, poslouchej samostatnou událost resize na window.visualViewport, pokud je toto API dostupné.

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

resize: bubbles=false, cancelable=false

Spusť kód v konzoli prohlížeče nebo v Node.js 24. V prohlížeči kód používá `window`, v Node.js samostatný objekt `EventTarget`. První syntetická událost synchronně zavolá posluchače a vypíše jeden řádek. Druhá se odešle až po odebrání posluchače, takže kód už nic nevypíše. Ani jedna událost nemění velikost zobrazované oblasti.

Související lekce

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

Zdroje