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

CKTIS / JavaScript

DOMContentLoaded — pripravljenost drevesa DOM

DOMContentLoaded označuje, da sta razčlenjevanje HTML-ja in izvajanje odloženih skriptov končana. Omogoča inicializacijo vmesnika, ne da bi čakali na popolno nalaganje strani.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

document.addEventListener("DOMContentLoaded", init, { once: true });

DOMContentLoaded je dogodek, ki se sproži na document, ko sta razčlenjevanje HTML-ja in izvajanje odloženih skriptov končana. Spada v standard HTML, ne v ECMAScript; podpirajo ga sodobni brskalniški pogoni. Sama prisotnost Node 24 ne zagotavlja brskalniškega document.

Ne pomeni, da so naloženi vsi viri: ne čaka na slike ali skripte async. Poznejši dogodek load na window pomeni naprednejšo fazo nalaganja. Slogovne datoteke lahko posredno zakasnijo DOMContentLoaded, ker blokirajo izvajanje odloženih skriptov.

Poslušalnik, dodan po dogodku, se ne izvede za nazaj. Zato primer preveri document.readyState: če je njegova vrednost "loading", registrira init; sicer jo takoj pokliče. Stanje "interactive" pomeni, da je razčlenjevanje končano, vendar ne dokazuje, da se je DOMContentLoaded že sprožil. Ta vzorec obravnava pripravljenost DOM-a; ne zagotavlja čakanja na preostale odložene skripte.

Skript je v primeru pred odstavkom. Čakanje prepreči prezgodnje iskanje elementa; po inicializaciji tako odstavek kot konzola prikažeta DOM ready.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOMContentLoaded example</title>
  <script>
    function init() {
      document.getElementById("status").textContent = "DOM ready";
      console.log("DOM ready");
    }

    if (document.readyState === "loading") {
      document.addEventListener("DOMContentLoaded", init, { once: true });
    } else {
      init();
    }
  </script>
</head>
<body>
  <p id="status">Waiting</p>
</body>
</html>

Rezultat

DOM ready

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri