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
- DOM Standard — Events, dispatch, propagation, and listener options
- Official reference — developer.mozilla.org: API / PageTransitionEvent
- HTML Standard — End of parsing, DOMContentLoaded, and load
- MDN Web Docs — Document: visibilitychange event
- MDN Web Docs — Window: unload event
- CSSOM View Module — Scroll and resize event processing
- HTML Standard — Common input element events
- UI Events — Keyboard and click events
- Pointer Events