CKTIS / JavaScript
Event.bubbles — eventbubbling
Event.bubbles is een alleen-lezen Boolean-eigenschap die aangeeft of een gebeurtenis vanaf het doel naar diens voorouders kan bubbelen. De waarde false schakelt noch de capturefase, noch de afhandeling op het doel zelf uit.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.bubbles
new Event(type, { bubbles: true })Event.bubbles geeft de Boolean-waarde terug die bij het initialiseren van de gebeurtenis is ingesteld. Bij new Event(type, options) is de optie bubbles standaard false; met { bubbles: true } wordt bubbling ingeschakeld.
Bubbling verloopt vanaf het doel in de richting van diens voorouders. false voorkomt niet dat de capturefase plaatsvindt of dat listeners op het doel worden aangeroepen. Het voorbeeld laat beide configuraties zien op een losgekoppelde DOM-boom.
bubbles geeft niet aan of de propagatie daadwerkelijk een voorouder heeft bereikt: stopPropagation() kan deze stoppen zonder deze eigenschap te wijzigen. cancelable gaat over annuleren met preventDefault(), terwijl composed gaat over het overschrijden van Shadow DOM-grenzen; dit zijn afzonderlijke instellingen.
Deze API hoort bij de DOM-standaard, niet bij ECMAScript zelf. Het voorbeeld vereist een browser-DOM; de aanwezigheid van Node 24 in een repository bewijst niet dat deze omgeving of browser-API’s worden ondersteund.
Voorbeelden
{
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'));
}Resultaat
capture: false target: false capture: true target: true bubble: true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.