База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Събитието `resize` на `Window`

Следи за `resize` на `window`, за да реагираш на промени в размера на областта за оформление на страницата. Използвай `ResizeObserver`, за да следиш размера на отделен елемент.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

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

Браузърът задейства resize на window, когато се промени размерът на областта, по която изчислява оформлението на страницата (layout viewport). Това е API на уеб платформата, а не част от ECMAScript. Браузърът подава обикновен обект Event, който не съдържа новите размери. Събитието не се разпространява нагоре (англ. bubbling) и не може да се отмени с preventDefault().

Прочети текущата ширина и височина от window.innerWidth и window.innerHeight. Стойностите са в CSS пиксели и включват съответно ширината на вертикалната и височината на хоризонталната лента за превъртане, ако има такива. Ако приложението се нуждае от размерите веднага, извикай функцията за обновяване при инициализация: самото регистриране на слушателя не я извиква. При преоразмеряване събитието може да възникне многократно, затова избягвай скъпи операции при всяко извикване.

С addEventListener("resize", handler) можеш да регистрираш няколко различни слушателя. Когато даден слушател вече не е нужен, премахни го с removeEventListener(), като подадеш същия тип събитие, същата референция към функцията и същата стойност на capture. Присвояването на window.onresize заменя само обработчика, зададен чрез това свойство, а не слушателите, добавени с addEventListener(). Присвояването на null премахва този обработчик.

Използвай ResizeObserver, за да следиш отделен елемент: размерът му може да се промени, без да се промени размерът на областта за оформление. За да следиш размера на видимата част на страницата, слушай за отделното събитие resize на window.visualViewport, ако този API е наличен.

Примери

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

Резултат

resize: bubbles=false, cancelable=false

Изпълни кода в конзолата на браузъра или в Node.js 24. В браузъра кодът използва `window`, а в Node.js — отделен обект `EventTarget`. Първото синтетично събитие извиква слушателя синхронно и извежда един ред. Второто се изпраща след премахването на слушателя, затова кодът не извежда нищо повече. Нито едно от събитията не променя размера на областта за показване.

Свързани уроци

  • JavaScript · Урок 27 · Средно · Версия: 3

Източници