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

CKTIS / JavaScript

Event.stopPropagation() — zastavení propagace události

stopPropagation() zastaví další propagaci události, ale nezruší výchozí akci ani ostatní listenery v rámci právě probíhajícího vyvolání.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

event.stopPropagation()

event.stopPropagation() je metoda DOM Web API, nikoli funkce ECMAScriptu. Vrací undefined. Zastavuje další propagaci během zachytávání i probublávání; již spuštěné listenery tím nevrátí zpět. Pokud se zavolá na předkovi během zachytávání, může zabránit tomu, aby událost dorazila ke svému cíli.

Nepřerušuje aktuální callback ani ostatní listenery v právě probíhajícím vyvolání na stejném objektu. stopImmediatePropagation() zastaví i tyto ostatní listenery. preventDefault() slouží k jinému účelu: zruší výchozí akci, pokud to událost a podmínky vyvolání umožňují.

V příkladu proběhne nejprve zachytávání na parent. První listener na child zablokuje probublávání k parent, ale druhý se přesto spustí. defaultPrevented zůstane false. Spusťte kód v prohlížeči; samotná přítomnost Node 24 nedokazuje podporu DOM v prohlížeči.

Příklady

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

parent.addEventListener('demo', () => log.push('parent capture'), true);
parent.addEventListener('demo', () => log.push('parent bubble'));
child.addEventListener('demo', (event) => {
  log.push('child first');
  event.stopPropagation();
});
child.addEventListener('demo', () => log.push('child second'));

const event = new Event('demo', { bubbles: true, cancelable: true });
child.dispatchEvent(event);
log.push(`defaultPrevented: ${event.defaultPrevented}`);
console.log(log.join('\n'));

Výsledek

parent capture
child first
child second
defaultPrevented: 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