CKTIS / JavaScript
Dogodki DOMContentLoaded, pagehide in scroll
Razlikuj med pripravljenostjo DOM-a, zapuščanjem strani in pomikanjem. Poslušalce dodaj pravim objektom in upoštevaj obnovitev iz predpomnilnika bfcache.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
document.addEventListener("scroll", onDocumentScroll);
scrollBox.addEventListener("scroll", onElementScroll);Ti dogodki brskalnika odgovorijo na tri različna vprašanja: Ali je DOM pripravljen na inicializacijo? Ali brskalnik zapušča ta dokument? Ali se je položaj pomika spremenil? So del spletne platforme in ne ECMAScripta. Zunaj brskalnika ne računaj na document in window.
DOMContentLoaded se sproži na document, ko je razčlenjevanje HTML-ja končano, so klasične skripte z defer izvedene in brskalnik začne vrednotiti module brez async, predvidene za konec razčlenjevanja. Dogodek ne čaka na konec asinhronega vrednotenja modulov: await na najvišji ravni v odvisnem modulu lahko odloži izvajanje telesa modula, ki ga uvaža, do trenutka po sprožitvi dogodka. Za razliko od load ne čaka na slike, vdelane okvirje ali skripte async. Slogovna predloga ga lahko posredno zakasni, če blokira izvajanje skripte.
Če se lahko inicializacijska koda izvede pozno, preveri document.readyState. Pri vrednosti "loading" dodaj enkratnega poslušalca za DOMContentLoaded; sicer inicializiraj takoj. "interactive" pomeni, da je razčlenjevanje končano, ne pa, da se je dogodek že sprožil ali da so se druge odložene skripte že izvedle.
Poslušaj pagehide na window, da se odzoveš na zapuščanje dokumenta, ne na navadno menjavo zavihka. Pri tem dogodku PageTransitionEvent vrednost event.persisted === true pomeni, da bo morda mogoče obnoviti dokument iz predpomnilnika za pomik nazaj in naprej po zgodovini (bfcache), vendar to ni zagotovljeno; false pomeni, da se dokument ne ohrani za ponovno uporabo. Po obnovitvi nadaljuj delo z pageshow in persisted === true, ne z DOMContentLoaded. pagehide se lahko ne sproži, na primer ko sistem konča mobilni brskalnik. Pomembno stanje shranjuj sproti; če želiš zaznati, da se je zavihek skril, uporabi visibilitychange in preveri stanje "hidden".
Pri pomikanju strani poslušaj scroll na document in preberi window.scrollY; pri vsebniku s pomikanjem poslušaj na samem elementu in preberi njegov scrollTop. Dogodek lahko sproži tudi pomik iz kode, ne pomeni pa, da se je pomikanje končalo. Obdelava dogodka naj bo kratka, saj si dogodki lahko hitro sledijo; po potrebi omeji pogostost zahtevnih posodobitev.
Primeri
(() => {
const viewportHeight = 80;
const contentHeight = 240;
function run(page, doc, createScrollBox) {
page.addEventListener("pagehide", (event) => {
console.log(`pagehide: persisted=${event.persisted}`);
});
function init() {
console.log("DOM ready");
const box = createScrollBox();
box.addEventListener("scroll", () => {
console.log(`scroll: ${box.scrollTop}`);
}, { once: true });
box.scrollTop = 40;
}
if (doc.readyState === "loading") {
doc.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
}
if (typeof window !== "undefined" && typeof document !== "undefined") {
run(window, document, () => {
const box = document.createElement("div");
box.style.cssText = `width: 200px; height: ${viewportHeight}px; overflow: auto`;
const content = document.createElement("div");
content.style.height = `${contentHeight}px`;
content.textContent = "Scroll demo";
box.append(content);
document.body.append(box);
return box;
});
return;
}
// Node.js stand-ins exercise the same listeners without a browser DOM.
class ScrollBox extends EventTarget {
#offset = 0;
get scrollTop() {
return this.#offset;
}
set scrollTop(value) {
const offset = Math.min(Math.max(0, value), contentHeight - viewportHeight);
if (offset === this.#offset) return;
this.#offset = offset;
setTimeout(() => this.dispatchEvent(new Event("scroll")), 0);
}
}
const page = new EventTarget();
const doc = new EventTarget();
doc.readyState = "loading";
run(page, doc, () => new ScrollBox());
doc.readyState = "interactive";
doc.dispatchEvent(new Event("DOMContentLoaded"));
})();Rezultat
DOM ready scroll: 40
Kodo enkrat zaženi v konzoli naložene prazne strani HTML. Inicializacija poteka takoj in koda pomakne vsebino vsebnika. Vklopi ohranjanje dnevnika in v istem zavihku odpri drug dokument. Poglej, ali se prikaže dodatna vrstica `pagehide: persisted=true` ali `pagehide: persisted=false`. Ta vrstica ni zagotovljena. V Node.js nadomestni objekti na osnovi `EventTarget` sprožijo iste funkcije za obravnavo pripravljenosti DOM-a in pomikanja, ne da bi preverili dejansko vedenje brskalnika.
Povezane lekcije
- JavaScript · Lekcija 45 · Napredna · Različica: 4