Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Dogodki brskalnika in njihovo širjenje

Z dogodki se koda odziva na dejanja uporabnika in spremembe stanja strani. Spoznaj zajem, cilj in mehurjenje, loči preklic privzetega dejanja od ustavitve širjenja ter razumi dogodke življenjskega cikla, vidnosti, pomikanja, spreminjanja velikosti in vnosa.

Različica: 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.

Sintaksa

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

Model in obseg

Dogodki brskalnika so del API-jev gostiteljskega okolja, ne skladnje ECMAScripta. Standard DOM določa model dogodkov, njihovo pošiljanje in širjenje ter možnosti nastavitve poslušalcev. Standard HTML med drugim določa, kdaj se sprožita DOMContentLoaded in load ter kdaj se pri kontrolnikih obrazca sprožita input in change. Teh API-jev ne povezuj z nobeno izdajo ECMAScripta. Node 24 ne potrjuje podpore za API-je brskalnika. Združljivost preveri v ciljnih brskalnikih.

Širjenje in preklic

addEventListener(type, handler, options) registrira obravnavalnik. Po zajemu pri prednikih sledi cilj, nato pa, če je bubbles resničen, še mehurjenje pri prednikih. target označuje cilj, currentTarget objekt aktivnega poslušalca. stopPropagation() ustavi nadaljnje širjenje, vendar ne preskoči preostalih poslušalcev v trenutnem nizu klicev. Če pa poslušalec z zajemom na cilju pokliče stopPropagation(), se ločeni niz klicev poslušalcev brez zajema na istem cilju ne izvede. stopImmediatePropagation() preskoči tudi preostale poslušalce v trenutnem nizu. preventDefault() prekliče privzeto dejanje le pri preklicljivem dogodku zunaj pasivnega poslušalca. Širjenja ne ustavi.

Življenjski cikel in vidnost

DOMContentLoaded na document pomeni konec razčlenjevanja in izvajanja skriptov, ki ga odložijo, ne pa nalaganja vseh virov. load na window počaka tudi na vire, ki ga zakasnijo. pageshow in pagehide zajemata prehode s predpomnilnikom za nazaj/naprej; preveri persisted. Ob visibilitychange na document preberi document.visibilityState. Skrita stran ni zaprta; unload ne zagotavlja končnega shranjevanja.

Pomikanje, velikost in vnos

scroll zadeva cilj pomikanja, resize na window pa velikost vidnega območja. Vsi dogodki ne mehurijo. Pogosti obravnavalniki naj bodo nezahtevni. input sporoča urejanje uporabnika, change pa potrditev spremembe glede na kontrolnik. Prireditev .value ne sproži nobenega. Loči keydown, dogodke kazalnika in semantični click; ne zanašaj se le na miško.

Upravljanje poslušalcev

once odstrani poslušalca pred prvim klicem njegovega obravnavalnika. Če ta obravnavalnik sinhrono sproži še en dogodek iste vrste, odstranjeni poslušalec tega dogodka ne obravnava. passive onemogoči učinek preventDefault(), signal pa omogoči odstranitev s prekinitvijo. Za removeEventListener ohrani tip, referenco funkcije in vrednost capture. V primeru je dispatchEvent() sinhron: false pomeni preklic, ne ustavitve širjenja.

Referenčni identifikatorji, zajeti v tem geslu: Page lifecycle, visibility, scroll/resize and input events.

Primeri

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

Rezultat

capture > target > bubble
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri