CKTIS / JavaScript
Udalosti DOMContentLoaded, pointerover, focusin, pagehide a pageshow
Vyber vhodnú udalosť pre pripravenosť DOM, delegovanie udalostí ukazovateľa a fokusu alebo navigáciu a obnovenie stránky z vyrovnávacej pamäte bfcache.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
document.addEventListener("DOMContentLoaded", onReady, { once: true });
container.addEventListener("pointerover", onPointerOver);
container.addEventListener("focusin", onFocusIn);
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);Poslucháče registruj pomocou addEventListener() a dodrž presnú veľkosť písmen. Tieto udalosti patria k webovej platforme, nie k ECMAScriptu 2024; podpora závisí od prostredia, v ktorom sa kód vykonáva.
DOMContentLoaded je nezrušiteľná udalosť typu Event vyvolaná na document po dokončení spracovania HTML, vykonaní klasických skriptov s defer a začatí vyhodnocovania modulov bez async naplánovaných na koniec spracovania. V okamihu vyvolania udalosti môže byť vyhodnocovanie modulu stále pozastavené na await na najvyššej úrovni. Nečaká na obrázky, vložené rámce ani skripty async. Ak sa kód môže spustiť neskoro a potrebuje len vytvorený DOM, pri document.readyState === "loading" použi jednorazový poslucháč; inak kód spusti hneď. Stav "interactive" sám osebe neznamená, že udalosť už nastala.
pointerover (PointerEvent) nastane, keď ukazovateľ vstúpi do oblasti prvku, v ktorej ho prehliadač zachytáva. Na dotykovej obrazovke to môže nastať pri dotyku. Prechod medzi potomkami môže vyvolať ďalšie udalosti. focusin (FocusEvent) nastane, keď prvok získa fokus, napríklad pomocou klávesnice alebo focus(), a nedá sa zrušiť. Obe udalosti sa šíria k predkom, na rozdiel od pointerenter a focus. Pri delegovaní označuje event.target cieľ a event.currentTarget kontajner s poslucháčom.
Na window počúvaj pagehide pri odchode z dokumentu počas navigácie a pageshow po prvom load aj pri obnovení dokumentu. Obe udalosti sú typu PageTransitionEvent. Pri pagehide znamená persisted === true, že prehliadač plánuje ponechať dokument vo vyrovnávacej pamäti na prechod späť a dopredu (bfcache), nezaručuje však obnovenie. Pri pageshow znamená true obnovenie z bfcache bez ďalšieho DOMContentLoaded a false nové načítanie dokumentu. Po obnovení pokračuj v práci bez opätovnej registrácie existujúcich poslucháčov.
Samotné prepnutie karty nie je navigácia a pageshow nedokazuje, že je stránka viditeľná. Viditeľnosť sleduj cez visibilitychange a document.visibilityState. Dôležité dáta ukladaj pri zmenách: pagehide môže chýbať, napríklad pri ukončení mobilného prehliadača.
Príklady
(() => {
const inBrowser = typeof document !== "undefined" && typeof window !== "undefined";
// Node's EventTarget has no DOM tree. Model just the bubbling used here.
class DemoNode extends EventTarget {
#parent = null;
constructor(localName) {
super();
this.localName = localName;
}
append(child) {
child.#parent = this;
}
dispatchEvent(event) {
// Keep the original target while EventTarget supplies currentTarget.
Object.defineProperty(event, "target", { value: this, configurable: true });
for (let node = this; node; node = node.#parent) {
super.dispatchEvent.call(node, event);
if (!event.bubbles || event.cancelBubble) break;
}
return !event.defaultPrevented;
}
}
class DemoPageTransitionEvent extends Event {
constructor(type, { persisted = false } = {}) {
super(type);
this.persisted = Boolean(persisted);
}
}
const doc = inBrowser ? document.implementation.createHTMLDocument() : new DemoNode("#document");
const page = inBrowser ? window : new EventTarget();
const Pointer = inBrowser ? window.PointerEvent : Event;
const Focus = inBrowser ? window.FocusEvent : Event;
const PageTransition = inBrowser ? window.PageTransitionEvent : DemoPageTransitionEvent;
const createElement = (name) => inBrowser ? doc.createElement(name) : new DemoNode(name);
const container = createElement("div");
const button = createElement("button");
container.append(button);
(inBrowser ? doc.body : doc).append(container);
doc.addEventListener("DOMContentLoaded", (event) => {
console.log(event.type);
});
for (const type of ["pointerover", "focusin"]) {
container.addEventListener(type, (event) => {
console.log(`${event.type}: ${event.target.localName} -> ${event.currentTarget.localName}`);
});
}
for (const type of ["pagehide", "pageshow"]) {
page.addEventListener(type, (event) => {
console.log(`${event.type}: persisted=${event.persisted}`);
}, { once: true });
}
doc.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
button.dispatchEvent(new Pointer("pointerover", { bubbles: true }));
button.dispatchEvent(new Focus("focusin", { bubbles: true }));
page.dispatchEvent(new PageTransition("pagehide", { persisted: true }));
page.dispatchEvent(new PageTransition("pageshow", { persisted: true }));
})();Výsledok
DOMContentLoaded pointerover: button -> div focusin: button -> div pagehide: persisted=true pageshow: persisted=true
Príklad vyvoláva syntetické udalosti. Ukazuje šírenie z `button` do `div` a výslovne zadanú hodnotu `persisted`; nemení fokus, nenaviguje ani nepoužíva bfcache. V prehliadači používa natívne API, v Node.js zjednodušený strom na šírenie udalostí.
Súvisiace lekcie
- JavaScript · Lekcia 39 · Pokročilá · Verzia: 4
Zdroje
- HTML Standard — The end of parsing
- Document: DOMContentLoaded event
- Element: pointerover event
- Pointer events
- Element: focusin event
- Window: pagehide event
- Window: pageshow event
- HTML Standard — The PageTransitionEvent interface
- Document: visibilitychange event
- EventTarget: dispatchEvent() method
- DOMImplementation: createHTMLDocument() method