CKTIS / JavaScript
Události prohlížeče a jejich šíření
Události umožňují reagovat na akce uživatele a změny stavu stránky. Poznej zachytávání, cíl a bublání, rozliš zrušení výchozí akce a zastavení šíření a seznam se s událostmi životního cyklu, viditelnosti, posunu, změny velikosti a vstupu.
Verze: 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.
Syntaxe
target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);Model a rozsah
Události prohlížeče patří k API hostitelského prostředí, nikoli k syntaxi ECMAScriptu. Standard DOM definuje model událostí, jejich vysílání a šíření i možnosti nastavení posluchačů. Standard HTML mimo jiné určuje, kdy nastávají události DOMContentLoaded a load a kdy se u formulářových prvků vyvolávají input a change. Nepřiřazuj tato API k žádnému vydání ECMAScriptu. Node 24 nedokládá podporu API prohlížeče. Ověř ji v cílových prohlížečích.
Šíření a rušení
addEventListener(type, handler, options) registruje obsluhu. Událost projde zachytáváním u předků, cílem a při pravdivém bubbles také bubláním u předků. target označuje cíl, currentTarget objekt právě běžícího posluchače. stopPropagation() zastaví další šíření, ale nevynechá zbývající posluchače v probíhající sérii volání. Pokud však zachytávající posluchač na cíli zavolá stopPropagation(), samostatná série volání posluchačů bez zachytávání na témže cíli neproběhne. stopImmediatePropagation() vynechá i zbývající posluchače v probíhající sérii. preventDefault() zruší výchozí akci jen u zrušitelné události mimo pasivní posluchač. Šíření nezastaví.
Životní cyklus a viditelnost
DOMContentLoaded na document značí konec analýzy a běhu skriptů, které událost odkládají, ne načtení všech zdrojů. load na window čeká i na zdroje, které ho zdržují. pageshow a pagehide zahrnují přechody s mezipamětí pro návrat a přechod vpřed; ověř persisted. Při visibilitychange na document čti document.visibilityState. Skrytí není zavření; unload nezaručí závěrečné uložení.
Posun, velikost a vstup
scroll se týká posouvaného cíle, resize na window velikosti zobrazovací oblasti. Ne vše bublá. Časté obsluhy mají být nenáročné. input značí úpravu uživatelem, change její potvrzení podle ovládacího prvku. Přiřazení .value nevyvolá ani jednu z nich. Rozlišuj keydown, události ukazatele a sémantický click; nespoléhej jen na myš.
Správa posluchačů
once odstraní posluchače před prvním zavoláním jeho obslužné funkce. Pokud tato funkce synchronně vyšle další událost stejného typu, odstraněný posluchač ji neobslouží. passive zneúčinní preventDefault() a signal umožní odstranění přerušením. Pro removeEventListener zachovej typ, referenci funkce a hodnotu capture. V příkladu běží dispatchEvent() synchronně: false značí zrušení, ne zastavení šíření.
Referenční identifikátory zahrnuté v tomto hesle: Page lifecycle, visibility, scroll/resize and input events.
Příklady
(() => {
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);
})();Výsledek
capture > target > bubble false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
Zdroje
- 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