CKTIS / JavaScript
Događaji DOMContentLoaded, pointerover, focusin, pagehide i pageshow
Odaberi odgovarajući događaj za spremnost DOM-a, delegiranje događaja pokazivača i fokusa ili navigaciju i obnovu stranice iz predmemorije bfcache.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
document.addEventListener("DOMContentLoaded", onReady, { once: true });
container.addEventListener("pointerover", onPointerOver);
container.addEventListener("focusin", onFocusIn);
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);Registriraj slušatelje metodom addEventListener() i pripazi na velika i mala slova u nazivima. Ti događaji pripadaju web-platformi, a ne ECMAScriptu 2024; podrška ovisi o izvršnom okruženju.
DOMContentLoaded je događaj tipa Event koji se ne može poništiti. Pokreće se na document nakon završetka raščlambe HTML-a, izvršavanja klasičnih skripti s defer i početka evaluacije modula bez async predviđenih za kraj raščlambe. U trenutku pokretanja događaja evaluacija modula još uvijek može biti zaustavljena na await na najvišoj razini. Ne čeka slike, ugrađene okvire ni skripte async. Ako se kôd može pokrenuti kasno i treba samo izgrađen DOM, dodaj jednokratni slušatelj ako vrijedi document.readyState === "loading"; u suprotnom odmah izvrši kôd. Samo stanje "interactive" ne znači da se događaj već dogodio.
pointerover (PointerEvent) pokreće se kad pokazivač uđe u područje u kojem ga element može registrirati; na dodirnom zaslonu to se može dogoditi pri dodiru. Prelazak između potomaka može proizvesti dodatne događaje. focusin (FocusEvent) pokreće se kad element dobije fokus, primjerice tipkovnicom ili pozivom focus(), i ne može se poništiti. Oba se događaja šire prema precima, za razliku od pointerenter i focus. Pri delegiranju event.target označava cilj događaja, a event.currentTarget spremnik sa slušateljem.
Na window slušaj pagehide pri napuštanju dokumenta tijekom navigacije, a pageshow nakon početnog load i pri obnovi dokumenta. Oba su tipa PageTransitionEvent. Za pagehide vrijednost persisted === true znači da preglednik namjerava zadržati dokument u predmemoriji za navigaciju natrag i naprijed (bfcache), ali obnova nije zajamčena. Za pageshow vrijednost true znači obnovu iz bfcache bez ponovnog DOMContentLoaded, a false novo učitavanje dokumenta. Nakon obnove nastavi s radom bez ponovne registracije postojećih slušatelja.
Samo prebacivanje između kartica nije navigacija, a pageshow ne dokazuje da je stranica vidljiva. Vidljivost prati pomoću visibilitychange i document.visibilityState. Važne podatke spremaj kad se promijene: pagehide može izostati, primjerice ako se prekine rad mobilnog preglednika.
Primjeri
(() => {
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 }));
})();Rezultat
DOMContentLoaded pointerover: button -> div focusin: button -> div pagehide: persisted=true pageshow: persisted=true
Primjer pokreće sintetičke događaje. Pokazuje širenje s `button` na `div` i izričito zadanu vrijednost `persisted`; ne premješta fokus, ne pokreće navigaciju i ne koristi bfcache. U pregledniku koristi izvorne API-je, a u Node.js-u pojednostavnjeno stablo za širenje događaja.
Povezane lekcije
- JavaScript · Lekcija 39 · Napredno · Verzija: 4
Izvori
- 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