KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Browsergebeurtenissen en propagatie

Met gebeurtenissen reageert code op gebruikersacties en wijzigingen in de paginastatus. Leer wat capture, target en bubbling zijn, onderscheid het annuleren van standaardgedrag van het stoppen van propagatie en ontdek gebeurtenissen rond levenscyclus, zichtbaarheid, scrollen, formaatwijziging en invoer.

Versie: Web APIs defined by web standards, not ECMAScript editions. Check support in target browsers; Node 24 in the repository does not establish browser API support.

Syntax

target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);

Model en bereik

Browsergebeurtenissen maken deel uit van de API’s van de hostomgeving, niet van de ECMAScript-syntaxis. De DOM-standaard definieert het gebeurtenismodel, de verzending en propagatie van gebeurtenissen en de opties voor listeners. De HTML-standaard bepaalt onder meer wanneer DOMContentLoaded en load optreden en wanneer input en change bij formulierelementen optreden. Koppel deze API’s niet aan een ECMAScript-editie. Node 24 bewijst niet dat browsers deze API’s ondersteunen. Controleer de compatibiliteit in de beoogde browsers.

Propagatie en annulering

addEventListener(type, handler, options) registreert een handler. Na capture bij voorouders volgt het doel en bij bubbles ook bubbling bij voorouders. target is het doel; currentTarget is het object van de actieve listener. stopPropagation() stopt verdere propagatie zonder de resterende listeners in de lopende aanroepronde over te slaan. Als een capture-listener op het doel stopPropagation() aanroept, wordt de aparte ronde voor listeners zonder capture op datzelfde doel niet uitgevoerd. stopImmediatePropagation() slaat ook de resterende listeners in de lopende ronde over. preventDefault() annuleert standaardgedrag alleen bij een annuleerbare gebeurtenis buiten een passieve listener. Het stopt geen propagatie.

Levenscyclus en zichtbaarheid

DOMContentLoaded op document: het parsen en de scripts die dit uitstellen zijn klaar, niet alle bronnen hoeven geladen te zijn. load op window wacht ook op bronnen die het vertragen. pageshow en pagehide omvatten de terug-/vooruitcache; bekijk persisted. Lees bij visibilitychange op document de waarde van document.visibilityState. Verborgen is niet gesloten; unload garandeert geen laatste opslag.

Scrollen, formaat en invoer

scroll betreft het scrolldoel, resize op window de grootte van de viewport. Niet alles bubbelt. Houd veelgebruikte handlers licht. input meldt bewerking door de gebruiker, change bevestiging afhankelijk van het bedieningselement. .value instellen activeert geen van beide. Onderscheid keydown, pointergebeurtenissen en semantische click; vertrouw niet alleen op de muis.

Listeners beheren

once verwijdert de listener voordat de callback voor het eerst wordt aangeroepen. Als die callback synchroon nog een gebeurtenis van hetzelfde type verstuurt, handelt de verwijderde listener die gebeurtenis niet af. passive maakt preventDefault() ineffectief en signal maakt verwijdering via afbreken mogelijk. Bewaar voor removeEventListener het type, de functiereferentie en de capture-waarde. In het voorbeeld is dispatchEvent() synchroon: false betekent annulering, niet gestopte propagatie.

Referentie-identificatoren die in dit item worden behandeld: Page lifecycle, visibility, scroll/resize and input events.

Voorbeelden

(() => {
  const parent = document.createElement('div');
  const child = document.createElement('button');
  parent.append(child);
  const log = [];

  parent.addEventListener('demo', () => log.push('capture'), { capture: true });
  child.addEventListener('demo', event => {
    log.push('target');
    event.preventDefault();
  });
  parent.addEventListener('demo', () => log.push('bubble'));

  const accepted = child.dispatchEvent(new Event('demo', {
    bubbles: true,
    cancelable: true
  }));
  console.log(log.join(' > '));
  console.log(accepted);
})();

Resultaat

capture > target > bubble
false

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.

Bronnen