CKTIS / JavaScript
Zdarzenia DOMContentLoaded, pagehide i scroll
Rozróżnij gotowość DOM, opuszczenie strony i przewijanie. Dobierz obiekt nasłuchujący i uwzględnij możliwość przywrócenia strony z pamięci bfcache.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
document.addEventListener("scroll", onDocumentScroll);
scrollBox.addEventListener("scroll", onElementScroll);Te zdarzenia przeglądarki odpowiadają na trzy różne pytania: czy DOM jest gotowy do inicjalizacji, czy przeglądarka opuszcza dokument i czy zmieniła się pozycja przewijania. Są częścią platformy WWW, a nie ECMAScriptu; nie zakładaj, że środowisko poza przeglądarką udostępnia document i window.
DOMContentLoaded jest wywoływane na document po zakończeniu parsowania HTML, wykonaniu klasycznych skryptów z defer i zainicjowaniu ewaluacji modułów bez async zaplanowanych na koniec parsowania. Zdarzenie nie czeka na zakończenie asynchronicznej ewaluacji modułów: await na najwyższym poziomie w zależności może opóźnić wykonanie kodu importującego modułu do chwili po wystąpieniu zdarzenia. W odróżnieniu od load nie czeka na obrazy, ramki podrzędne ani skrypty async. Arkusz stylów może opóźnić to zdarzenie pośrednio, jeśli blokuje wykonanie skryptu.
Jeśli kod inicjalizacyjny może uruchomić się późno, sprawdź document.readyState. Przy "loading" zarejestruj jednorazowy nasłuch DOMContentLoaded; w przeciwnym razie zainicjalizuj od razu. Stan "interactive" oznacza koniec parsowania, ale nie dowodzi, że zdarzenie już wystąpiło ani że inne skrypty odroczone zakończyły pracę.
Nasłuchuj pagehide na window, aby zareagować na opuszczenie dokumentu, a nie na samo przełączenie karty. W zdarzeniu PageTransitionEvent wartość event.persisted === true oznacza, że stronę można jeszcze przywrócić z pamięci historii wstecz/do przodu (bfcache), ale nie gwarantuje przywrócenia; false oznacza, że ten dokument nie jest zachowywany do ponownego użycia. Wznowienie po przywróceniu obsłuż przez pageshow z persisted === true, nie przez DOMContentLoaded. pagehide może nie wystąpić, np. gdy system zamknie przeglądarkę mobilną. Zapisuj ważny stan w trakcie pracy; do wykrywania ukrycia karty użyj visibilitychange i sprawdź, czy stan to "hidden".
Nasłuchuj scroll na document dla przewijania strony i odczytuj window.scrollY; dla przewijanego kontenera nasłuchuj na samym elemencie i odczytuj jego scrollTop. Zdarzenie może wynikać również z przewijania przez kod i nie oznacza końca przewijania. Procedura obsługi powinna wykonywać mało pracy, bo zdarzenia mogą następować szybko po sobie; w razie potrzeby ogranicz częstotliwość kosztownych aktualizacji.
Przykłady
(() => {
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"));
})();Wynik
DOM ready scroll: 40
Uruchom kod raz w konsoli na wczytanej pustej stronie HTML. Inicjalizacja nastąpi od razu, a kod sam przewinie kontener. Włącz zachowywanie dziennika i przejdź do innego dokumentu w tej samej karcie, aby poszukać dodatkowego wpisu `pagehide: persisted=true` lub `pagehide: persisted=false`. Ten wpis nie jest gwarantowany. W Node.js obiekty zastępcze oparte na `EventTarget` pozwalają uruchomić te same procedury obsługi gotowości i przewijania, ale nie sprawdzają rzeczywistego zachowania przeglądarki.
Powiązane lekcje
- JavaScript · Lekcja 45 · Zaawansowany · Wersja: 4