CKTIS / JavaScript
DOMContentLoaded — pripravenosť stromu DOM
DOMContentLoaded signalizuje, že sa dokončilo parsovanie HTML a spustenie odložených skriptov. Umožňuje inicializovať rozhranie bez čakania na úplné načítanie stránky.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
document.addEventListener("DOMContentLoaded", init, { once: true });DOMContentLoaded je udalosť vyvolaná na document po dokončení parsovania HTML a spustenia odložených skriptov. Patrí do štandardu HTML, nie ECMAScriptu; súčasné prehliadačové enginy ju podporujú. Samotná prítomnosť Node 24 neposkytuje prehliadačové document.
Neznamená to, že sa načítali všetky zdroje: nečaká na obrázky ani skripty async. Neskoršia udalosť load na window predstavuje pokročilejšiu fázu načítania. Štýly môžu nepriamo oneskoriť DOMContentLoaded tým, že blokujú spustenie odložených skriptov.
Listener pridaný až po udalosti sa spätne nespustí. Príklad preto kontroluje document.readyState: ak má hodnotu "loading", zaregistruje init; inak ju zavolá okamžite. Stav "interactive" znamená, že parsovanie sa skončilo, ale nedokazuje, že už bola vyvolaná udalosť DOMContentLoaded. Tento vzor rieši pripravenosť DOM; nezaručuje čakanie na zostávajúce odložené skripty.
Skript je v príklade pred odsekom. Čakanie zabráni príliš skorému hľadaniu prvku; po inicializácii zobrazí odsek aj konzola DOM ready.
Príklady
<!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>Výsledok
DOM ready
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.