CKTIS / JavaScript
Udalosti DOMContentLoaded, pagehide a scroll
Rozlišuj pripravenosť DOM, opustenie stránky a posúvanie. Vyber správny objekt pre poslucháča a počítaj s možným obnovením 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 });
window.addEventListener("pagehide", onPageHide);
document.addEventListener("scroll", onDocumentScroll);
scrollBox.addEventListener("scroll", onElementScroll);Tieto udalosti prehliadača odpovedajú na tri rôzne otázky: Je DOM pripravený na inicializáciu? Opúšťa prehliadač dokument? Zmenila sa poloha posunu? Patria do webovej platformy, nie do ECMAScriptu. Mimo prehliadača nepredpokladaj dostupnosť document a window.
DOMContentLoaded sa vyvolá na document po dokončení analýzy HTML, vykonaní klasických skriptov s defer a začatí vyhodnocovania modulov bez async naplánovaných na koniec analýzy. Udalosť nečaká na dokončenie asynchrónneho vyhodnocovania modulov: await na najvyššej úrovni v závislosti môže odložiť vykonanie tela modulu, ktorý ju importuje, až po vyvolaní udalosti. Na rozdiel od load nečaká na obrázky, vnorené rámce ani skripty async. Súbor so štýlmi môže túto udalosť nepriamo oneskoriť, ak blokuje skript.
Ak sa inicializačný kód môže spustiť neskoro, skontroluj document.readyState. Pri hodnote "loading" zaregistruj jednorazového poslucháča udalosti DOMContentLoaded; inak inicializuj hneď. "interactive" znamená, že analýza sa skončila, nie že už nastala udalosť alebo sa dokončili ostatné odložené skripty.
Udalosť pagehide sleduj na window, ak chceš reagovať na opustenie dokumentu, nie na obyčajné prepnutie karty. Pri tejto udalosti PageTransitionEvent hodnota event.persisted === true znamená, že dokument sa môže obnoviť z vyrovnávacej pamäte pre navigáciu späť a dopredu (bfcache), no obnovenie nie je zaručené; false znamená, že sa dokument neuchová na opätovné použitie. Pri obnovení pokračuj pomocou pageshow s persisted === true, nie cez DOMContentLoaded. pagehide nemusí nastať, napríklad keď systém ukončí mobilný prehliadač. Dôležité údaje ukladaj priebežne; na zistenie skrytia karty použi visibilitychange a skontroluj stav "hidden".
Pri posúvaní stránky sleduj scroll na document a čítaj window.scrollY; pri posúvateľnom kontajneri sleduj udalosť priamo na prvku a čítaj jeho scrollTop. Udalosť môže vyvolať aj posun vykonaný kódom a neoznamuje koniec posúvania. Obsluha má byť nenáročná, lebo udalosti môžu prichádzať rýchlo za sebou; podľa potreby obmedz frekvenciu nákladných aktualizácií.
Príklady
(() => {
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"));
})();Výsledok
DOM ready scroll: 40
Spusť kód raz v konzole načítanej prázdnej stránky HTML. Inicializácia prebehne hneď a kód posunie obsah kontajnera. Zapni uchovávanie záznamu a v rovnakej karte prejdi na iný dokument. Sleduj, či pribudne riadok `pagehide: persisted=true` alebo `pagehide: persisted=false`. Tento riadok nie je zaručený. V Node.js náhradné objekty založené na `EventTarget` spúšťajú rovnaké obsluhy udalostí pre pripravenosť DOM a posúvanie, no neoverujú skutočné správanie prehliadača.
Súvisiace lekcie
- JavaScript · Lekcia 45 · Pokročilá · Verzia: 4