Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Zdarzenia przeglądarki i propagacja

Zdarzenia pozwalają reagować na działania użytkownika i zmiany stanu strony. Poznaj przechwytywanie, cel i bąbelkowanie, różnicę między anulowaniem akcji domyślnej a zatrzymaniem propagacji oraz zdarzenia cyklu życia, widoczności, przewijania, rozmiaru i wprowadzania danych.

Wersja: Web APIs defined by web standards, not ECMAScript editions. Check support in target browsers; Node 24 in the repository does not establish browser API support.

Składnia

target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);

Model i zakres

Zdarzenia przeglądarki są częścią API środowiska, a nie składni ECMAScript. Standard DOM definiuje model zdarzeń, ich wysyłanie i propagację oraz opcje nasłuchu. Standard HTML określa między innymi, kiedy występują DOMContentLoaded, load oraz zdarzenia input i change w kontrolkach formularza. Nie przypisuj tych API do edycji ECMAScript; Node 24 nie potwierdza obsługi API przeglądarki. Zgodność trzeba sprawdzić dla docelowych przeglądarek.

Propagacja i anulowanie

addEventListener(type, handler, options) rejestruje funkcję obsługi. Zdarzenie przechodzi przez przechwytywanie u przodków, cel i — gdy bubbles jest prawdziwe — bąbelkowanie u przodków. target wskazuje cel, a currentTarget obiekt bieżącego nasłuchu. stopPropagation() zatrzymuje dalszą propagację, ale nie pomija pozostałych funkcji obsługi w bieżącej serii wywołań nasłuchów. Jeśli jednak wywołasz stopPropagation() w nasłuchu przechwytującym na celu zdarzenia, osobna seria wywołań nasłuchów nieprzechwytujących na tym samym celu się nie rozpocznie. stopImmediatePropagation() pomija również pozostałe funkcje obsługi w bieżącej serii. preventDefault() anuluje akcję domyślną tylko dla zdarzenia anulowalnego i poza pasywnym nasłuchem. Nie zatrzymuje propagacji.

Cykl życia i widoczność

DOMContentLoaded na document oznacza zakończenie parsowania i wykonania skryptów odraczających to zdarzenie, nie załadowanie wszystkich zasobów. load na window czeka również na zasoby opóźniające ładowanie. pageshow i pagehide obejmują przejścia związane z pamięcią bfcache; sprawdzaj persisted. Przy visibilitychange na document odczytuj document.visibilityState. Ukrycie nie oznacza zamknięcia; nie polegaj na unload jako gwarantowanym zapisie końcowym.

Przewijanie, rozmiar i dane wejściowe

scroll dotyczy przewijanego celu, a resize na window zmiany rozmiaru obszaru widoku; nie zakładaj, że każde zdarzenie bąbelkuje. Ograniczaj koszt częstych wywołań. input sygnalizuje edycję przez użytkownika, a change zatwierdzenie zmiany zależne od kontrolki; przypisanie .value samo ich nie wysyła. Rozróżniaj keydown, zdarzenia wskaźnika i semantyczny click; nie opieraj obsługi wyłącznie na myszy.

Zarządzanie nasłuchem

once usuwa nasłuch przed pierwszym wywołaniem funkcji obsługi. Jeśli ta funkcja synchronicznie wyśle kolejne zdarzenie tego samego typu, usunięty nasłuch nie obsłuży tego zdarzenia. passive wyklucza skuteczne preventDefault(), a signal umożliwia usunięcie przez przerwanie. Przy removeEventListener zachowaj typ, referencję funkcji i wartość capture. Przykład używa synchronicznego dispatchEvent(); wynik false oznacza anulowanie, nie zatrzymanie propagacji.

Identyfikatory objęte tym wpisem: Page lifecycle, visibility, scroll/resize and input events.

Przykłady

(() => {
  const parent = document.createElement('div');
  const child = document.createElement('button');
  parent.append(child);
  const log = [];

  parent.addEventListener('demo', () => log.push('capture'), { capture: true });
  child.addEventListener('demo', event => {
    log.push('target');
    event.preventDefault();
  });
  parent.addEventListener('demo', () => log.push('bubble'));

  const accepted = child.dispatchEvent(new Event('demo', {
    bubbles: true,
    cancelable: true
  }));
  console.log(log.join(' > '));
  console.log(accepted);
})();

Wynik

capture > target > bubble
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła