Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Dogodki DOMContentLoaded, pointerover, focusin, pagehide in pageshow

Izberi pravi dogodek za pripravljenost DOM-a, delegiranje dogodkov kazalca in fokusa ali navigacijo in obnovitev strani iz predpomnilnika bfcache.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

document.addEventListener("DOMContentLoaded", onReady, { once: true });
container.addEventListener("pointerover", onPointerOver);
container.addEventListener("focusin", onFocusIn);
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);

Poslušalce registriraj z addEventListener() in upoštevaj velike in male črke v imenih. Ti dogodki spadajo v spletno platformo, ne v ECMAScript 2024; podpora je odvisna od izvajalnega okolja.

DOMContentLoaded je dogodek tipa Event, ki ga ni mogoče preklicati. Sproži se na document po koncu razčlenjevanja HTML-ja, izvedbi klasičnih skript z defer in začetku vrednotenja modulov brez async, predvidenih za konec razčlenjevanja. Ob sprožitvi dogodka je vrednotenje modula lahko še vedno zaustavljeno pri await na vrhnji ravni. Ne čaka na slike, vdelane okvirje ali skripte async. Če se koda lahko zažene pozno in potrebuje le zgrajen DOM, pri document.readyState === "loading" uporabi enkratnega poslušalca; sicer kodo izvedi takoj. "interactive" sam po sebi še ne pomeni, da se je dogodek že sprožil.

pointerover (PointerEvent) se sproži, ko kazalec vstopi v območje zaznavanja elementa; na zaslonu na dotik se to lahko zgodi ob dotiku. Premikanje med potomci lahko sproži dodatne dogodke. focusin (FocusEvent) se sproži, ko element dobi fokus, na primer s tipkovnico ali prek focus(), in ga ni mogoče preklicati. Oba dogodka se širita navzgor do prednikov, v nasprotju z pointerenter in focus. Pri delegiranju event.target označuje cilj dogodka, event.currentTarget pa vsebnik s poslušalcem.

Na window poslušaj pagehide ob odhodu iz dokumenta med navigacijo in pageshow po začetnem load ter ob obnovitvi dokumenta. Oba sta tipa PageTransitionEvent. Pri pagehide pomeni persisted === true, da namerava brskalnik dokument obdržati v predpomnilniku za pomik nazaj in naprej (bfcache), vendar obnovitev ni zagotovljena. Pri pageshow pomeni true obnovitev iz bfcache brez ponovnega DOMContentLoaded, false pa novo nalaganje dokumenta. Ob obnovitvi nadaljuj delo brez ponovnega registriranja obstoječih poslušalcev.

Samo preklapljanje med zavihki ni navigacija in pageshow ne dokazuje, da je stran vidna. Vidnost spremljaj z visibilitychange in document.visibilityState. Pomembne podatke shrani ob spremembah: pagehide lahko izostane, na primer, če se izvajanje brskalnika na mobilni napravi prekine.

Primeri

(() => {
  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 }));
})();

Rezultat

DOMContentLoaded
pointerover: button -> div
focusin: button -> div
pagehide: persisted=true
pageshow: persisted=true

Primer sproži sintetične dogodke. Pokaže širjenje z `button` na `div` in izrecno podano vrednost `persisted`; ne premakne fokusa, ne izvede navigacije in ne uporabi bfcache. V brskalniku uporablja izvorne API-je, v Node.js pa poenostavljeno drevo za širjenje dogodkov.

Povezane lekcije

  • JavaScript · Lekcija 39 · Napredna · Različica: 4

Viri