CKTIS / JavaScript
Event.bubbles — mjehurićasto širenje događaja
Event.bubbles je logičko svojstvo samo za čitanje koje pokazuje može li se događaj širiti od svojeg cilja prema precima. Vrijednost false ne isključuje fazu hvatanja ni obradu događaja na samom cilju.
Verzija: 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.bubbles
new Event(type, { bubbles: true })Event.bubbles vraća logičku vrijednost određenu pri inicijalizaciji događaja. U new Event(type, options) opcija bubbles prema zadanim je postavkama false; postavljanjem { bubbles: true } uključuje se mjehurićasto širenje.
Mjehurićasto širenje kreće se od cilja prema njegovim precima. false ne sprječava fazu hvatanja ni pozivanje slušatelja na cilju. Primjer prikazuje obje konfiguracije na odvojenom DOM stablu.
bubbles ne pokazuje je li širenje doista stiglo do pretka: stopPropagation() može ga zaustaviti bez promjene tog svojstva. cancelable se odnosi na otkazivanje pomoću preventDefault(), a composed na prelazak granica Shadow DOM-a; to su zasebne postavke.
Ovaj API pripada standardu DOM, a ne samom ECMAScriptu. Primjer zahtijeva DOM preglednika; prisutnost Node 24 u repozitoriju ne dokazuje podršku za ovo okruženje ni API-je preglednika.
Primjeri
{
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'));
}Rezultat
capture: false target: false capture: true target: true bubble: true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.