Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje