CKTIS / JavaScript
Události DOMContentLoaded, pointerover, focusin, pagehide a pageshow
Vyber správnou událost pro připravenost DOM, delegování událostí ukazatele a fokusu nebo navigaci a obnovu stránky z mezipaměti bfcache.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
document.addEventListener("DOMContentLoaded", onReady, { once: true });
container.addEventListener("pointerover", onPointerOver);
container.addEventListener("focusin", onFocusIn);
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);Posluchače registruj pomocí addEventListener() a dodržuj přesnou velikost písmen. Tyto události patří k webové platformě, nikoli k ECMAScriptu 2024. Jejich podpora závisí na běhovém prostředí.
DOMContentLoaded je nezrušitelná událost typu Event vyvolaná na document po dokončení zpracování HTML, vykonání klasických skriptů s defer a zahájení vyhodnocování modulů bez async naplánovaných na konec zpracování. V okamžiku vyvolání události může být vyhodnocování modulu stále pozastavené na await na nejvyšší úrovni. Nečeká na obrázky, vložené rámce ani skripty async. Pokud se kód může spustit pozdě a potřebuje jen vytvořený DOM, při document.readyState === "loading" použij jednorázový posluchač; jinak kód spusť ihned. Stav "interactive" sám o sobě neznamená, že událost už nastala.
pointerover (PointerEvent) nastane, když ukazatel vstoupí do oblasti prvku, která zachycuje ukazatel; na dotykové obrazovce to může být při dotyku. Přechod mezi potomky může vyvolat další události. focusin (FocusEvent) nastane, když prvek získá fokus, například klávesnicí nebo voláním focus(), a nelze ji zrušit. Obě události probublávají k předkům, na rozdíl od pointerenter a focus. Při delegování označuje event.target cíl a event.currentTarget kontejner s posluchačem.
Na window poslouchej pagehide při opuštění dokumentu během navigace a pageshow po prvním load i při obnově dokumentu. Obě události jsou typu PageTransitionEvent. U pagehide znamená persisted === true, že prohlížeč hodlá uchovat dokument v mezipaměti pro přechod zpět a vpřed (bfcache), ale jeho obnova není zaručená. U pageshow znamená true obnovu z bfcache bez dalšího DOMContentLoaded, zatímco false značí nové načtení dokumentu. Po obnově pokračuj v práci bez opětovné registrace stávajících posluchačů.
Samotné přepnutí karty není navigace a pageshow nedokazuje, že je stránka viditelná. Viditelnost sleduj pomocí visibilitychange a document.visibilityState. Důležitá data ukládej průběžně: pagehide nemusí nastat, například při ukončení mobilního prohlížeče.
Pří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ýsledek
DOMContentLoaded pointerover: button -> div focusin: button -> div pagehide: persisted=true pageshow: persisted=true
Příklad vyvolává syntetické události. Ukazuje probublávání z `button` do `div` a výslovně zadanou hodnotu `persisted`; nemění fokus, nenaviguje a nepoužívá bfcache. V prohlížeči používá nativní API, v Node.js zjednodušený strom pro šíření událostí.
Související lekce
- JavaScript · Lekce 39 · Pokročilá · Verze: 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