CKTIS / JavaScript
Gli eventi DOMContentLoaded, pagehide e scroll
Distingui quando il DOM è pronto, quando si lascia la pagina e quando cambia lo scorrimento. Scegli il destinatario dell’evento e considera il ripristino dalla bfcache.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
document.addEventListener("scroll", onDocumentScroll);
scrollBox.addEventListener("scroll", onElementScroll);Questi eventi del browser rispondono a tre domande diverse: il DOM è pronto per l’inizializzazione? Il browser sta lasciando il documento? È cambiata la posizione di scorrimento? Appartengono alla piattaforma web, non a ECMAScript: non dare per scontato che fuori dal browser esistano document e window.
DOMContentLoaded si attiva su document dopo che l’analisi dell’HTML è terminata, gli script classici con defer sono stati eseguiti e il browser ha avviato la valutazione dei moduli senza async previsti per la fine dell’analisi. L’evento non attende la fine della valutazione asincrona dei moduli: un await al livello superiore in una dipendenza può ritardare l’esecuzione del corpo del modulo che la importa fino a dopo l’evento. A differenza di load, non attende immagini, frame incorporati o script async. Un foglio di stile può ritardarlo indirettamente se blocca uno script.
Se il codice di inizializzazione potrebbe partire tardi, controlla document.readyState. Se vale "loading", registra un listener monouso per DOMContentLoaded; altrimenti inizializza subito. "interactive" significa che l’analisi è terminata, non che l’evento si sia già verificato o che gli altri script differiti abbiano finito.
Ascolta pagehide su window per reagire quando il browser lascia il documento, non quando si cambia semplicemente scheda. In questo PageTransitionEvent, event.persisted === true indica che il documento potrebbe essere ripristinato dalla cache di navigazione avanti/indietro (bfcache), senza garantirlo; false significa che non viene conservato per il riutilizzo. Per riprendere il lavoro dopo il ripristino usa pageshow con persisted === true, non DOMContentLoaded. pagehide può mancare, per esempio se il sistema termina il browser su un dispositivo mobile. Salva i dati importanti man mano; per rilevare quando una scheda diventa nascosta, usa visibilitychange e verifica lo stato "hidden".
Per lo scorrimento della pagina ascolta scroll su document e leggi window.scrollY; per un contenitore scorrevole, ascolta l’evento sull’elemento stesso e leggi il suo scrollTop. Anche lo scorrimento avviato dal codice può attivare l’evento, che non indica la fine dello scorrimento. Mantieni leggero il gestore, perché gli eventi possono susseguirsi rapidamente; se necessario, limita la frequenza degli aggiornamenti costosi.
Esempi
(() => {
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"));
})();Risultato
DOM ready scroll: 40
Esegui il codice una sola volta nella console di una pagina HTML vuota già caricata. L’inizializzazione è immediata e il codice fa scorrere il contenitore. Attiva la conservazione del log e apri un altro documento nella stessa scheda per cercare una riga aggiuntiva `pagehide: persisted=true` o `pagehide: persisted=false`. La riga non è garantita. In Node.js, oggetti sostitutivi basati su `EventTarget` eseguono gli stessi gestori per la disponibilità del DOM e lo scorrimento, senza verificare il comportamento effettivo del browser.
Lezioni correlate
- JavaScript · Lezione 45 · Avanzato · Versione: 4