Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori