CKTIS / JavaScript
DOMContentLoaded — připravenost stromu DOM
DOMContentLoaded signalizuje, že bylo dokončeno parsování HTML a spuštění odložených skriptů. Umožňuje inicializovat rozhraní bez čekání na úplné načtení stránky.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.addEventListener("DOMContentLoaded", init, { once: true });DOMContentLoaded je událost vyvolaná na document po dokončení parsování HTML a spuštění odložených skriptů. Patří do standardu HTML, nikoli ECMAScriptu; současné prohlížečové enginy ji podporují. Samotná přítomnost Node 24 neposkytuje prohlížečové document.
Neznamená to, že byly načteny všechny prostředky: nečeká na obrázky ani skripty async. Pozdější událost load na window představuje pokročilejší fázi načítání. Styly mohou nepřímo zpozdit DOMContentLoaded tím, že blokují spuštění odložených skriptů.
Listener přidaný až po události se zpětně nespustí. Příklad proto kontroluje document.readyState: pokud má hodnotu "loading", zaregistruje init; jinak ji zavolá okamžitě. Stav "interactive" znamená, že parsování skončilo, ale nedokazuje, že už byla vyvolána událost DOMContentLoaded. Tento vzor řeší připravenost DOM; nezaručuje čekání na zbývající odložené skripty.
Skript je v příkladu před odstavcem. Čekání zabrání příliš časnému hledání prvku; po inicializaci zobrazí odstavec i konzole DOM ready.
Pří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ýsledek
DOM ready
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.