Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje