База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Event.bubbles — разпространение на събития с изплуване

Event.bubbles е логическо свойство само за четене, което показва дали дадено събитие може да се разпространява от целта си към предците ѝ. Стойността false не изключва фазата на прихващане или обработването на самата цел.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

event.bubbles
new Event(type, { bubbles: true })

Event.bubbles връща логическата стойност, зададена при инициализирането на събитието. При new Event(type, options) опцията bubbles по подразбиране е false; задаването на { bubbles: true } включва разпространението с изплуване.

Разпространението с изплуване започва от целта и продължава към предците ѝ. false не възпрепятства фазата на прихващане или извикването на слушатели върху целта. Примерът показва и двете конфигурации в отделено DOM дърво.

bubbles не показва дали разпространението действително е достигнало предшественик: stopPropagation() може да го спре, без да промени това свойство. cancelable се отнася до отмяната чрез preventDefault(), а composed — до преминаването през границите на Shadow DOM; това са отделни настройки.

Този API е част от стандарта DOM, а не от самия ECMAScript. Примерът изисква DOM на браузър; наличието на Node 24 в хранилище не доказва поддръжка на тази среда или на API на браузъра.

Примери

{
  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'));
}

Резултат

capture: false
target: false
capture: true
target: true
bubble: true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници