Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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