Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Zdarzenie `resize` obiektu `Window`

Nasłuchuj zdarzenia `resize` na `window`, aby reagować na zmianę wymiarów obszaru układu strony. Do obserwowania rozmiaru pojedynczego elementu użyj `ResizeObserver`.

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

Składnia

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

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

Przeglądarka wywołuje zdarzenie resize na obiekcie window, gdy zmienia się rozmiar obszaru widoku używanego do obliczania układu strony (layout viewport). Jest to API platformy webowej, a nie część ECMAScriptu. Przeglądarka przekazuje zwykły obiekt Event bez nowych wymiarów. Zdarzenie nie bąbelkuje i nie można go anulować za pomocą preventDefault().

Odczytaj bieżącą szerokość i wysokość z window.innerWidth i window.innerHeight. Wartości są podane w pikselach CSS i obejmują odpowiednio szerokość pionowego i wysokość poziomego paska przewijania, jeśli występują. Jeżeli aplikacja potrzebuje wymiarów od razu, wywołaj funkcję aktualizującą podczas inicjalizacji: samo dodanie nasłuchu jej nie uruchamia. Podczas zmiany rozmiaru zdarzenie może wystąpić wielokrotnie, więc nie wykonuj kosztownych operacji przy każdym wywołaniu.

addEventListener("resize", handler) pozwala zarejestrować kilka różnych funkcji. Gdy nasłuch nie jest już potrzebny, usuń go przez removeEventListener() z tym samym typem zdarzenia, tą samą funkcją i taką samą wartością capture. Przypisanie do window.onresize zastępuje tylko funkcję ustawioną we właściwości, a nie nasłuchy dodane przez addEventListener(); przypisanie null usuwa funkcję z właściwości.

Do obserwowania zmian rozmiaru konkretnego elementu użyj ResizeObserver: element może zmienić rozmiar bez zmiany rozmiaru obszaru układu strony. Aby śledzić rozmiar widocznej części strony, nasłuchuj osobnego zdarzenia resize na window.visualViewport, jeśli to API jest dostępne.

Przykłady

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

Wynik

resize: bubbles=false, cancelable=false

Uruchom kod w konsoli przeglądarki lub w Node.js 24. W przeglądarce kod używa `window`, a w Node.js odrębnego obiektu `EventTarget`. Pierwsze syntetyczne zdarzenie synchronicznie wywołuje funkcję i wypisuje jeden wiersz. Drugie następuje po usunięciu nasłuchu, więc kod nic więcej nie wypisuje. Żadne z tych zdarzeń nie zmienia rozmiaru obszaru widoku.

Powiązane lekcje

  • JavaScript · Lekcja 27 · Średniozaawansowany · Wersja: 3

Źródła