CKTIS / JavaScript
Zdarzenia DOMContentLoaded, pointerover, focusin, pagehide i pageshow
Dobierz zdarzenie do gotowości DOM, delegowania obsługi wskaźnika i fokusu albo nawigacji i przywracania strony z pamięci bfcache.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
document.addEventListener("DOMContentLoaded", onReady, { once: true });
container.addEventListener("pointerover", onPointerOver);
container.addEventListener("focusin", onFocusIn);
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);Rejestruj nasłuch przez addEventListener(), używając nazw z dokładną wielkością liter. Są to zdarzenia platformy webowej, nie funkcje ECMAScript 2024; obsługa zależy od środowiska.
DOMContentLoaded to nieanulowalne zdarzenie typu Event wysyłane do document po zakończeniu analizy HTML, wykonaniu klasycznych skryptów z defer i rozpoczęciu ewaluacji modułów bez async zaplanowanych na koniec analizy. Zdarzenie może wystąpić, gdy ewaluacja modułu jest jeszcze wstrzymana na instrukcji await na najwyższym poziomie. Nie czeka na obrazy, zagnieżdżone ramki ani skrypty async. Jeśli kod może zostać uruchomiony późno i potrzebuje tylko zbudowanego DOM, nasłuchuj raz przy document.readyState === "loading"; w przeciwnym razie działaj od razu. Stan "interactive" sam w sobie nie dowodzi, że zdarzenie już wystąpiło.
pointerover (PointerEvent) występuje, gdy wskaźnik znajdzie się w obszarze trafienia elementu; na ekranie dotykowym może to nastąpić przy dotknięciu. Przechodzenie między potomkami może generować kolejne zdarzenia. focusin (FocusEvent) występuje, gdy element otrzymuje fokus, np. z klawiatury lub przez focus(), i nie można go anulować. Oba zdarzenia propagują się w górę, w przeciwieństwie do pointerenter i focus. Przy delegowaniu event.target wskazuje cel zdarzenia, a event.currentTarget — kontener z nasłuchem.
Na window nasłuchuj pagehide przy opuszczaniu dokumentu w trakcie nawigacji oraz pageshow po początkowym load i przy przywracaniu dokumentu. Oba mają typ PageTransitionEvent. Przy pagehide wartość persisted === true oznacza zamiar zachowania dokumentu w pamięci nawigacji wstecz i naprzód (bfcache), ale nie gwarantuje przywrócenia. Przy pageshow wartość true oznacza przywrócenie z bfcache bez ponownego DOMContentLoaded; wartość false oznacza nowe wczytanie dokumentu. Wznawiaj pracę po przywróceniu bez ponownego dodawania istniejących nasłuchów.
Samo przełączenie karty to nie nawigacja, a pageshow nie dowodzi, że użytkownik widzi stronę. Do obserwowania widoczności użyj visibilitychange i document.visibilityState. Zapisuj ważne dane na bieżąco: pagehide może nie wystąpić, np. gdy system zakończy działanie przeglądarki mobilnej.
Przykłady
(() => {
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 }));
})();Wynik
DOMContentLoaded pointerover: button -> div focusin: button -> div pagehide: persisted=true pageshow: persisted=true
Przykład wysyła zdarzenia syntetyczne. Pokazuje propagację z `button` do `div` i jawnie ustawione `persisted`; nie nadaje fokusu, nie wykonuje nawigacji ani nie korzysta z bfcache. W przeglądarce używa natywnych API, a w Node.js — uproszczonego modelu drzewa zdarzeń.
Powiązane lekcje
- JavaScript · Lekcja 39 · Zaawansowany · Wersja: 4
Źródła
- 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