CKTIS / JavaScript
Event.bubbles — propagazione degli eventi
Event.bubbles è una proprietà booleana di sola lettura che indica se un evento può propagarsi dal suo target ai suoi antenati. Il valore false non disattiva la fase di cattura né la gestione dell’evento sul target stesso.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
event.bubbles
new Event(type, { bubbles: true })Event.bubbles restituisce il valore booleano stabilito quando l’evento viene inizializzato. In new Event(type, options), l’opzione bubbles è false per impostazione predefinita; impostando { bubbles: true } si attiva la propagazione.
La propagazione procede dal target verso i suoi antenati. false non impedisce la fase di cattura né l’invocazione dei listener sul target. L’esempio mostra entrambe le configurazioni su un albero DOM scollegato.
bubbles non indica se la propagazione abbia effettivamente raggiunto un antenato: stopPropagation() può interromperla senza modificare questa proprietà. cancelable riguarda l’annullamento tramite preventDefault(), mentre composed riguarda il superamento dei confini dello Shadow DOM; sono impostazioni distinte.
Questa API appartiene allo standard DOM, non a ECMAScript in sé. L’esempio richiede un DOM del browser; la presenza di Node 24 in un repository non dimostra il supporto per questo ambiente o per le API del browser.
Esempi
{
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'));
}Risultato
capture: false target: false capture: true target: true bubble: true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.