CKTIS / JavaScript
Događaji preglednika i njihovo širenje
Događaji omogućuju kodu da reagira na korisničke radnje i promjene stanja stranice. Upoznaj hvatanje, cilj i širenje prema precima, razlikuj poništavanje zadane radnje od zaustavljanja širenja te prouči događaje životnog ciklusa, vidljivosti, pomicanja, promjene veličine i unosa.
Verzija: 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 i opseg
Događaji preglednika dio su API-ja okruženja, a ne sintakse ECMAScripta. Standard DOM definira model događaja, njihovo slanje i širenje te opcije slušatelja. Standard HTML, među ostalim, određuje kada se pokreću DOMContentLoaded i load te kada se na kontrolama obrasca pokreću input i change. Ne veži te API-je uz izdanje ECMAScripta. Node 24 ne potvrđuje podršku za API-je preglednika. Provjeri kompatibilnost u ciljanim preglednicima.
Širenje i poništavanje
addEventListener(type, handler, options) registrira obrađivač. Nakon hvatanja na precima slijedi cilj, a ako je bubbles istinit, i širenje prema precima. target označava cilj; currentTarget objekt aktivnog slušatelja. stopPropagation() zaustavlja daljnje širenje, ali ne preskače preostale slušatelje u tekućem nizu poziva. No ako slušatelj s hvatanjem na cilju pozove stopPropagation(), zaseban niz poziva slušatelja bez hvatanja na tom istom cilju neće se izvršiti. stopImmediatePropagation() preskače i preostale slušatelje u tekućem nizu. preventDefault() poništava zadanu radnju samo za poništiv događaj izvan pasivnog slušatelja. Ne zaustavlja širenje.
Životni ciklus i vidljivost
DOMContentLoaded na document znači kraj raščlambe i izvršavanja skripti koje ga odgađaju, ne učitavanje svih resursa. load na window čeka i resurse koji ga odgađaju. pageshow i pagehide obuhvaćaju predmemoriju za natrag/naprijed; provjeri persisted. Pri visibilitychange na document očitaj document.visibilityState. Skrivena stranica nije zatvorena; unload ne jamči završno spremanje.
Pomicanje, veličina i unos
scroll se odnosi na cilj pomicanja, a resize na window na veličinu vidljivog područja. Ne širi se sve prema precima. Česti obrađivači neka budu lagani. input javlja korisničku izmjenu, change potvrdu koja ovisi o kontroli. Dodjela .value ne pokreće nijedan. Razlikuj keydown, događaje pokazivača i semantički click; ne oslanjaj se samo na miš.
Upravljanje slušateljima
once uklanja slušatelja prije prvog poziva njegova obrađivača. Ako taj obrađivač sinkrono pokrene još jedan događaj iste vrste, uklonjeni slušatelj neće obraditi taj događaj. passive onemogućuje učinak preventDefault(), a signal dopušta uklanjanje prekidom. Za removeEventListener zadrži tip, referencu funkcije i vrijednost capture. U primjeru je dispatchEvent() sinkron: false znači poništavanje, ne zaustavljeno širenje.
Referentni identifikatori obuhvaćeni ovim unosom: Page lifecycle, visibility, scroll/resize and input events.
Primjeri
(() => {
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- DOM Standard — Events, dispatch, propagation, and listener options
- Official reference — developer.mozilla.org: API / PageTransitionEvent
- HTML Standard — End of parsing, DOMContentLoaded, and load
- MDN Web Docs — Document: visibilitychange event
- MDN Web Docs — Window: unload event
- CSSOM View Module — Scroll and resize event processing
- HTML Standard — Common input element events
- UI Events — Keyboard and click events
- Pointer Events