Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Događaji DOMContentLoaded, pagehide i scroll

Razlikuj spremnost DOM-a, napuštanje stranice i pomicanje sadržaja. Odaberi pravi objekt za slušatelj i računaj na mogućnost povratka iz predmemorije bfcache.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
document.addEventListener("scroll", onDocumentScroll);
scrollBox.addEventListener("scroll", onElementScroll);

Ti događaji preglednika odgovaraju na tri različita pitanja: Je li DOM spreman za inicijalizaciju? Napušta li preglednik dokument? Je li se promijenio položaj pomicanja? Dio su web-platforme, a ne ECMAScripta. Izvan preglednika ne pretpostavljaj da su document i window dostupni.

DOMContentLoaded se aktivira na document nakon što završi raščlamba HTML-a, izvrše se klasične skripte s defer i preglednik pokrene evaluaciju modula bez async predviđenih za kraj raščlambe. Događaj ne čeka završetak asinkrone evaluacije modula: await na najvišoj razini u ovisnosti može odgoditi izvršavanje tijela modula koji je uvozi do trenutka nakon aktiviranja događaja. Za razliku od load, ne čeka slike, ugrađene okvire ni skripte async. Stilska datoteka može ga neizravno odgoditi ako blokira skriptu.

Ako se inicijalizacijski kôd može izvršiti kasno, provjeri document.readyState. Ako je vrijednost "loading", registriraj jednokratni slušatelj za DOMContentLoaded; u suprotnom inicijaliziraj odmah. "interactive" znači da je raščlamba dovršena, ali ne i da se događaj već aktivirao ili da su se ostale odgođene skripte izvršile.

Slušaj pagehide na window da reagiraš na napuštanje dokumenta, a ne na puko prebacivanje kartice. Kod tog događaja PageTransitionEvent, event.persisted === true pokazuje da se dokument možda može obnoviti iz predmemorije za navigaciju natrag i naprijed (bfcache), ali to nije zajamčeno; false znači da se dokument ne čuva za ponovnu upotrebu. Nakon obnove nastavi s radom pomoću pageshow i persisted === true, ne pomoću DOMContentLoaded. pagehide može izostati, primjerice ako sustav zaustavi mobilni preglednik. Važne podatke spremaj tijekom rada; skrivanje kartice prepoznaj pomoću visibilitychange i provjere stanja "hidden".

Kad se pomiče stranica, slušaj scroll na document i čitaj window.scrollY; za pomični spremnik slušaj na samom elementu i čitaj njegov scrollTop. Događaj može izazvati i pomicanje pokrenuto kôdom te on ne označava kraj pomicanja. Neka obrada bude lagana jer se događaji mogu brzo nizati; po potrebi ograniči učestalost zahtjevnih ažuriranja.

Primjeri

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

Rezultat

DOM ready
scroll: 40

Pokreni kôd jednom u konzoli učitane prazne HTML stranice. Inicijalizacija počinje odmah, a kôd pomiče sadržaj spremnika. Uključi zadržavanje zapisnika i prijeđi na drugi dokument u istoj kartici. Provjeri pojavljuje li se dodatni redak `pagehide: persisted=true` ili `pagehide: persisted=false`. Taj redak nije zajamčen. U Node.js-u zamjenski objekti temeljeni na `EventTarget` pokreću iste funkcije za obradu događaja spremnosti DOM-a i pomicanja, ali ne provjeravaju stvarno ponašanje preglednika.

Povezane lekcije

  • JavaScript · Lekcija 45 · Napredno · Verzija: 4

Izvori