CKTIS / JavaScript
Event.stopPropagation() — ustavitev širjenja dogodka
stopPropagation() ustavi nadaljnje širjenje dogodka, vendar ne prekliče privzetega dejanja in ne ustavi preostalih poslušalnikov v trenutnem klicu.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
event.stopPropagation()event.stopPropagation() je metoda DOM Web API, ne funkcija ECMAScript. Vrne undefined. Ustavi nadaljnje širjenje tako med zajemanjem kot med mehurjenjem; že izvedenih poslušalnikov ne razveljavi. Če jo pokličemo na predniku med zajemanjem, lahko prepreči, da bi dogodek dosegel cilj.
Ne prekine trenutnega povratnega klica niti preostalih poslušalnikov v trenutnem klicu na istem objektu. stopImmediatePropagation() ustavi tudi te preostale poslušalnike. preventDefault() ima drugačen namen: prekliče privzeto dejanje, kadar to dopuščata dogodek in pogoji klica.
V primeru se najprej izvede zajemanje na parent. Prvi poslušalnik na child prepreči mehurjenje do parent, drugi pa se vseeno izvede. defaultPrevented ostane false. Kodo zaženi v brskalniku; prisotnost Node 24 ne dokazuje podpore za DOM brskalnika.
Primeri
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'));Rezultat
parent capture child first child second defaultPrevented: false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.