CKTIS / JavaScript
Udalosti DOMContentLoaded, hashchange, mouseover a focusin
Vyber správny cieľ počúvania pre pripravenosť DOM, zmenu fragmentu URL, vstup ukazovateľa a získanie fokusu. Udalosti potomkov môžeš spracovať v spoločnom kontajneri.
Verzia: Current web platform; runtime support varies
Syntax
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("hashchange", onHashChange);
container.addEventListener("mouseover", onMouseOver);
container.addEventListener("focusin", onFocusIn);Tieto štyri udalosti oznamujú rôzne situácie: pripravenosť dokumentu, navigáciu podľa fragmentu, pohyb ukazovateľa a zmenu fokusu. Ide o rozhrania webovej platformy. Údaj ECMAScript 2024 v poli verzie označuje iba verziu jazyka JavaScript a nehovorí, či sú tieto udalosti podporované. Over podporu v cieľových prehliadačoch: samotné prostredie JavaScriptu nezaručuje dostupnosť DOM.
Udalosť DOMContentLoaded počúvaj na document. Prehliadač vyvolá túto nezrušiteľnú udalosť typu Event po spracovaní HTML a spustení klasických skriptov s defer aj modulových skriptov bez async. Nečaká na obrázky ani skripty async; štýly ju môžu nepriamo oneskoriť blokovaním skriptu. Ak inicializácia potrebuje len zostavený DOM, pri document.readyState === "loading" zaregistruj poslucháča s { once: true }, inak inicializuj ihneď. Stav "interactive" nedokazuje, že udalosť už nastala.
Udalosť hashchange počúvaj na window, keď navigácia zmení fragment URL v tom istom dokumente, napríklad priradením hodnoty do location.hash. HashChangeEvent obsahuje úplné adresy URL v oldURL a newURL. Volanie history.pushState() ani history.replaceState() samo nevyvolá hashchange, ani keď sa fragment zmení.
mouseover je udalosť typu MouseEvent vyvolaná na prvku, na ktorý vstúpi ukazovateľ. Šíri sa k predkom, takže aj pohyb medzi potomkami môže spustiť poslucháča kontajnera. relatedTarget označuje opustený prvok alebo má hodnotu null, ak vedľajší cieľ neexistuje. Ak chceš zachytiť iba vstup zvonku do kontajnera, počúvaj priamo mouseenter, ktorý sa k predkom nešíri.
focusin je nezrušiteľná udalosť typu FocusEvent vyvolaná, keď prvok získa fokus, napríklad po stlačení Tab. Na rozdiel od focus sa focusin šíri k predkom. Pri delegovaní focusin alebo mouseover v bežnom strome DOM použi event.target na určenie dotknutého prvku a event.currentTarget na určenie kontajnera, ktorého poslucháč práve beží.
Príklady
(() => {
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,
};
}
})();Výsledok
DOMContentLoaded: document=true hashchange: #before -> #after mouseover: button=true, container=true focusin: button=true, container=true
Spusti kód v konzole prehliadača na `about:blank` alebo ho ulož ako `main.js` a spusti príkazom `node main.js`. Prehliadač používa svoj natívny DOM, kým v Node.js kód používa iba zjednodušený model stromu a udalostí. `dispatchEvent()` vyvoláva syntetické udalosti synchrónne: znova nenačíta dokument, nezmení URL ani nepresunie ukazovateľ či fokus. Posledné dva riadky ukazujú šírenie z tlačidla do kontajnera, ktorý nie je pripojený k dokumentu.
Súvisiace lekcie
- JavaScript · Lekcia 38 · Pokročilá · Verzia: 4
Zdroje
- 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