Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Event.stopPropagation() — zastavenie propagácie udalosti

stopPropagation() zastaví ďalšiu propagáciu udalosti, ale nezruší predvolenú akciu ani ostatné listenery v rámci aktuálneho vyvolania.

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

Syntax

event.stopPropagation()

event.stopPropagation() je metóda DOM Web API, nie funkcia ECMAScriptu. Vráti undefined. Zastaví ďalšiu propagáciu počas zachytávania aj prebublávania; už vykonané listenery tým nevráti späť. Ak sa zavolá na predkovi počas zachytávania, môže zabrániť tomu, aby udalosť dosiahla svoj cieľ.

Neprerušuje aktuálny callback ani ostatné listenery v rámci aktuálneho vyvolania na tom istom objekte. stopImmediatePropagation() zastaví aj tieto ostatné listenery. preventDefault() má inú úlohu: zruší predvolenú akciu, ak to udalosť a podmienky vyvolania umožňujú.

V príklade prebehne najprv zachytávanie na parent. Prvý listener na child zablokuje prebublávanie k parent, ale druhý sa aj tak vykoná. defaultPrevented zostane false. Spustite kód v prehliadači; samotná prítomnosť Node 24 nedokazuje podporu DOM v prehliadači.

Prí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ýsledok

parent capture
child first
child second
defaultPrevented: false

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje