CKTIS / JavaScript
Event.bubbles — probublávání událostí
Event.bubbles je logická vlastnost pouze pro čtení, která určuje, zda může událost probublávat od svého cíle k předkům. Hodnota false nevypíná zachytávání ani zpracování události přímo na cíli.
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.bubbles
new Event(type, { bubbles: true })Event.bubbles vrací logickou hodnotu nastavenou při inicializaci události. U new Event(type, options) má volba bubbles výchozí hodnotu false; nastavením { bubbles: true } se probublávání zapne.
Probublávání postupuje od cíle směrem k jeho předkům. false nebrání fázi zachytávání ani vyvolání posluchačů na cíli. Příklad ukazuje obě konfigurace na odpojeném stromu DOM.
bubbles neříká, zda propagace skutečně dosáhla předka: stopPropagation() ji může zastavit, aniž by tuto vlastnost změnilo. cancelable se týká zrušení pomocí preventDefault(), zatímco composed se týká překročení hranic Shadow DOM; jde o samostatná nastavení.
Toto API patří ke standardu DOM, nikoli k samotnému ECMAScriptu. Příklad vyžaduje DOM prohlížeče; přítomnost Node 24 v repozitáři nedokládá podporu tohoto prostředí ani API prohlížeče.
Příklady
{
const parent = document.createElement('div');
const child = document.createElement('div');
parent.appendChild(child);
const log = [];
parent.addEventListener('demo', (event) => {
log.push(`capture: ${event.bubbles}`);
}, { capture: true });
child.addEventListener('demo', (event) => {
log.push(`target: ${event.bubbles}`);
});
parent.addEventListener('demo', (event) => {
log.push(`bubble: ${event.bubbles}`);
});
child.dispatchEvent(new Event('demo'));
child.dispatchEvent(new Event('demo', { bubbles: true }));
console.log(log.join('\n'));
}Výsledek
capture: false target: false capture: true target: true bubble: true
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.