CKTIS / JavaScript
Събитията DOMContentLoaded, pointerover, focusin, pagehide и pageshow
Избери подходящото събитие за готовността на DOM, делегирането на събития за показалец и фокус или навигацията и възстановяването от кеша bfcache.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
document.addEventListener("DOMContentLoaded", onReady, { once: true });
container.addEventListener("pointerover", onPointerOver);
container.addEventListener("focusin", onFocusIn);
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);Регистрирай слушатели с addEventListener() и спазвай точно главните и малките букви в имената. Тези събития са част от уеб платформата, а не от ECMAScript 2024; поддръжката зависи от средата за изпълнение.
DOMContentLoaded е неотменимо събитие от тип Event, изпращано към document след приключването на разбора на HTML, изпълнението на класическите скриптове с defer и началото на изпълнението на модулите без async, планирани за края на разбора. При настъпването на събитието изпълнението на даден модул все още може да е спряло на await на най-горно ниво. То не изчаква изображения, вградени рамки или скриптове с async. Ако кодът може да стартира късно и се нуждае само от изграден DOM, при document.readyState === "loading" регистрирай еднократен слушател; иначе изпълни кода веднага. Само състоянието "interactive" не означава, че събитието вече е настъпило.
pointerover (PointerEvent) настъпва, когато показалецът навлезе в областта, в която браузърът го отчита върху елемента; при сензорен екран това може да стане при докосване. Преминаването между наследници може да предизвика още събития. focusin (FocusEvent) настъпва, когато елемент получи фокус, например чрез клавиатурата или focus(), и не може да бъде отменено. И двете събития се разпространяват нагоре към предците, за разлика от pointerenter и focus. При делегиране event.target посочва целта, а event.currentTarget — контейнера със слушателя.
На window слушай за pagehide при напускане на документа по време на навигация и за pageshow след първоначалното load и при възстановяване на документа. И двете са от тип PageTransitionEvent. При pagehide стойността persisted === true означава, че браузърът възнамерява да запази документа в кеша за навигация назад и напред (bfcache), без да гарантира възстановяването му. При pageshow стойността true означава възстановяване от bfcache без ново DOMContentLoaded, а false — ново зареждане на документа. При възстановяване продължи работата, без да регистрираш повторно съществуващите слушатели.
Самото превключване на раздел не е навигация, а pageshow не доказва, че страницата е видима. Следи видимостта с visibilitychange и document.visibilityState. Запазвай важните данни при промяна: pagehide може да не настъпи, например ако работата на мобилния браузър бъде прекратена.
Примери
(() => {
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 }));
})();Резултат
DOMContentLoaded pointerover: button -> div focusin: button -> div pagehide: persisted=true pageshow: persisted=true
Примерът изпраща синтетични събития. Показва разпространението от `button` към `div` и изрично зададена стойност на `persisted`; не премества фокуса, не извършва навигация и не използва bfcache. В браузър използва вградените API, а в Node.js — опростено дърво за разпространение на събитията.
Свързани уроци
- JavaScript · Урок 39 · Напреднало · Версия: 4
Източници
- 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