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

CKTIS / JavaScript

Dogodek `resize` objekta `Window`

Z dogodkom `resize` na objektu `window` se odzovi na spremembe velikosti območja za postavitev strani. Za spremljanje velikosti posameznega elementa uporabi `ResizeObserver`.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

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

Brskalnik sproži dogodek resize na objektu window, ko se spremeni velikost območja, ki ga uporablja za izračun postavitve strani (layout viewport). To je API spletne platforme, ne del ECMAScripta. Brskalnik posreduje običajen objekt Event brez novih mer. Dogodek se ne širi navzgor po drevesu (angl. bubbling) in ga ni mogoče preklicati z preventDefault().

Trenutno širino in višino preberi iz window.innerWidth in window.innerHeight. Vrednosti sta v slikovnih pikah CSS in vključujeta širino navpičnega oziroma višino vodoravnega drsnega traku, če sta prisotna. Če aplikacija potrebuje mere takoj, pokliči funkcijo za posodobitev ob inicializaciji: sama registracija poslušalca funkcije ne pokliče. Med spreminjanjem velikosti se lahko dogodek sproži večkrat, zato se pri vsakem klicu izogni zahtevnim opravilom.

Z addEventListener("resize", handler) lahko registriraš več različnih poslušalcev. Ko poslušalca ne potrebuješ več, ga odstrani z removeEventListener() z isto vrsto dogodka, istim sklicem na funkcijo in isto vrednostjo capture. Prirejanje lastnosti window.onresize zamenja samo funkcijo, nastavljeno prek te lastnosti, ne pa poslušalcev, dodanih z addEventListener(). S prireditvijo null to funkcijo odstraniš.

Za spremljanje posameznega elementa uporabi ResizeObserver: element lahko spremeni velikost, tudi če se velikost območja za postavitev ne spremeni. Za spremljanje velikosti vidnega dela strani poslušaj ločeni dogodek resize na window.visualViewport, če je ta API na voljo.

Primeri

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

Rezultat

resize: bubbles=false, cancelable=false

Kodo zaženi v konzoli brskalnika ali v okolju Node.js 24. V brskalniku koda uporablja `window`, v okolju Node.js pa samostojen objekt `EventTarget`. Prvi sintetični dogodek sinhrono pokliče poslušalca in izpiše eno vrstico. Drugi je poslan po odstranitvi poslušalca, zato koda ne izpiše ničesar več. Nobeden od dogodkov ne spremeni velikosti prikaznega območja.

Povezane lekcije

  • JavaScript · Lekcija 27 · Srednja · Različica: 3

Viri