CKTIS / JavaScript
Događaji DOMContentLoaded, hashchange, mouseover i focusin
Odaberi gdje slušati spremnost DOM-a, promjenu fragmenta URL-a, ulazak pokazivača i dobivanje fokusa. Obradu događaja potomaka delegiraj zajedničkom spremniku.
Verzija: Current web platform; runtime support varies
Sintaksa
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("hashchange", onHashChange);
container.addEventListener("mouseover", onMouseOver);
container.addEventListener("focusin", onFocusIn);Ova četiri događaja označavaju različite situacije: spremnost dokumenta, navigaciju po fragmentima, pomicanje pokazivača i promjenu fokusa. To su sučelja web-platforme. Oznaka ECMAScript 2024 u polju verzije odnosi se samo na jezik JavaScript i ne govori jesu li ti događaji podržani. Provjeri podršku u ciljanim preglednicima: samo JavaScript okruženje ne jamči pristup DOM-u.
Slušaj DOMContentLoaded na objektu document. Preglednik pokreće taj neotkazivi Event nakon raščlambe HTML-a i izvršavanja klasičnih skripti s defer i modulskih skripti bez async. Ne čeka slike ni skripte s async; stilske tablice mogu ga neizravno odgoditi ako blokiraju skriptu. Ako je za inicijalizaciju dovoljan izgrađeni DOM, pri document.readyState === "loading" registriraj slušatelja s { once: true }, a inače odmah pokreni inicijalizaciju. Stanje "interactive" ne dokazuje da se događaj već zbio.
Slušaj hashchange na objektu window kada navigacija promijeni fragment URL-a unutar istog dokumenta, primjerice dodjelom vrijednosti svojstvu location.hash. HashChangeEvent sadrži potpune URL-ove u oldURL i newURL. Poziv history.pushState() ili history.replaceState() sam po sebi ne pokreće hashchange, čak ni ako se fragment promijeni.
mouseover je MouseEvent pokrenut na elementu na koji je pokazivač ušao. Širi se prema precima, pa prelazak između potomaka također može aktivirati slušatelja spremnika. relatedTarget označava element koji je pokazivač napustio ili ima vrijednost null ako nema sekundarnog cilja. Ako želiš prepoznati samo ulazak u spremnik izvana, slušaj mouseenter izravno na spremniku: taj se događaj ne širi prema precima.
focusin je neotkazivi FocusEvent pokrenut kad element dobije fokus, primjerice pritiskom na Tab. Za razliku od focus, focusin se širi prema precima. Pri delegiranju focusin ili mouseover u običnom stablu DOM-a, event.target označava zahvaćeni element, a event.currentTarget spremnik čiji se slušatelj upravo izvršava.
Primjeri
(() => {
const { document, window, HashChangeEvent, MouseEvent, FocusEvent } =
typeof globalThis.document === "undefined" ? createNodeDemo() : globalThis;
const container = document.createElement("div");
const button = document.createElement("button");
container.append(button);
document.addEventListener("DOMContentLoaded", (event) => {
console.log(`${event.type}: document=${event.target === document}`);
}, { once: true });
window.addEventListener("hashchange", (event) => {
console.log(`${event.type}: ${new URL(event.oldURL).hash} -> ${new URL(event.newURL).hash}`);
}, { once: true });
for (const type of ["mouseover", "focusin"]) {
container.addEventListener(type, (event) => {
console.log(`${event.type}: button=${event.target === button}, container=${event.currentTarget === container}`);
});
}
document.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
window.dispatchEvent(new HashChangeEvent("hashchange", {
oldURL: "https://example.com/#before",
newURL: "https://example.com/#after",
}));
button.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
button.dispatchEvent(new FocusEvent("focusin", { bubbles: true }));
// Node.js fallback: model only the detached tree and event data used here.
function createNodeDemo() {
class DemoElement extends EventTarget {
parentNode = null;
append(child) {
child.parentNode = this;
}
dispatchEvent(event) {
let current = this;
Object.defineProperties(event, {
target: { configurable: true, value: this },
currentTarget: { configurable: true, get: () => current },
});
try {
for (; current; current = current.parentNode) {
EventTarget.prototype.dispatchEvent.call(current, event);
if (!event.bubbles || event.cancelBubble) break;
}
} finally {
current = null;
}
return !event.defaultPrevented;
}
}
class DemoHashChangeEvent extends Event {
constructor(type, { oldURL, newURL }) {
super(type);
this.oldURL = oldURL;
this.newURL = newURL;
}
}
return {
document: Object.assign(new EventTarget(), {
createElement: () => new DemoElement(),
}),
window: new EventTarget(),
HashChangeEvent: DemoHashChangeEvent,
MouseEvent: Event,
FocusEvent: Event,
};
}
})();Rezultat
DOMContentLoaded: document=true hashchange: #before -> #after mouseover: button=true, container=true focusin: button=true, container=true
Pokreni kôd u konzoli preglednika na `about:blank` ili ga spremi kao `main.js` i pokreni naredbom `node main.js`. Preglednik koristi svoj DOM, a u okruženju Node.js kôd umjesto DOM-a koristi pojednostavljeni model stabla i događaja. `dispatchEvent()` sinkrono pokreće sintetičke događaje: ne učitava dokument ponovno, ne mijenja URL te ne pomiče pokazivač ni fokus. Posljednja dva retka pokazuju širenje događaja s gumba na spremnik koji nije povezan s dokumentom.
Povezane lekcije
- JavaScript · Lekcija 38 · Napredno · Verzija: 4
Izvori
- HTML Standard — The end
- Document: DOMContentLoaded event
- Window: hashchange event
- HTML Standard — The HashChangeEvent interface
- Element: mouseover event
- Element: mouseenter event
- MouseEvent: relatedTarget property
- Element: focusin event
- Element: focus event
- EventTarget: addEventListener() method
- EventTarget: dispatchEvent() method