CKTIS / JavaScript
DOMContentLoaded — spremnost DOM stabla
DOMContentLoaded označava da su završeni parsiranje HTML-a i izvođenje odgođenih skripti. Omogućuje inicijalizaciju sučelja bez čekanja na potpuno učitavanje stranice.
Verzija: 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 događaj koji se aktivira na document nakon završetka parsiranja HTML-a i izvođenja odgođenih skripti. Dio je HTML standarda, a ne ECMAScripta; podržavaju ga suvremeni preglednički pogoni. Sama prisutnost Nodea 24 ne pruža preglednički document.
To ne znači da su učitani svi resursi: ne čeka slike ni skripte async. Kasniji događaj load na window označava potpuniju fazu učitavanja. Stilski listovi mogu neizravno odgoditi DOMContentLoaded blokiranjem izvođenja odgođenih skripti.
Listener dodan nakon događaja ne izvršava se retroaktivno. Zato primjer provjerava document.readyState: ako je vrijednost "loading", registrira init; u suprotnom je odmah poziva. Stanje "interactive" znači da je parsiranje završeno, ali ne dokazuje da se DOMContentLoaded već aktivirao. Ovaj obrazac obrađuje spremnost DOM-a; ne jamči čekanje na preostale odgođene skripte.
Skripta je u primjeru prije odlomka. Čekanje sprječava prerano traženje elementa; nakon inicijalizacije i odlomak i konzola prikazuju DOM ready.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.