CKTIS / JavaScript
Event.bubbles — prebublávanie udalostí
Event.bubbles je logická vlastnosť iba na čítanie, ktorá určuje, či môže udalosť prebublávať od svojho cieľa k predkom. Hodnota false nevypína zachytávanie ani spracovanie udalosti priamo na cieli.
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.bubbles
new Event(type, { bubbles: true })Event.bubbles vracia logickú hodnotu nastavenú pri inicializácii udalosti. Pri new Event(type, options) má možnosť bubbles predvolenú hodnotu false; nastavením { bubbles: true } sa prebublávanie zapne.
Prebublávanie postupuje od cieľa smerom k jeho predkom. false nebráni fáze zachytávania ani vyvolaniu poslucháčov na cieli. Príklad ukazuje obe konfigurácie na odpojenom strome DOM.
bubbles nehovorí, či propagácia skutočne dosiahla predka: stopPropagation() ju môže zastaviť bez zmeny tejto vlastnosti. cancelable sa týka zrušenia pomocou preventDefault(), zatiaľ čo composed sa týka prekročenia hraníc Shadow DOM; ide o samostatné nastavenia.
Toto API patrí do štandardu DOM, nie do samotného ECMAScriptu. Príklad vyžaduje DOM prehliadača; prítomnosť Node 24 v repozitári nedokladá podporu tohto prostredia ani API prehliadača.
Prí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ýsledok
capture: false target: false capture: true target: true bubble: true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.