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

CKTIS / JavaScript

Rozdíl mezi `document.body` a `document.documentElement`

Přes `document.body` získáš prvek s obsahem stránky, přes `document.documentElement` kořenový prvek dokumentu. Obě vlastnosti mohou vrátit `null`.

Verze: Current web platform; runtime support varies

Syntaxe

document.body
 document.documentElement
 document.body = newBody

document.documentElement vrací kořenový prvek dokumentu, nebo null, pokud žádný neexistuje. Na běžné stránce HTML je to <html>; v dokumentu XML se kořenový prvek může jmenovat jinak. Vlastnost je jen pro čtení, ale vrácený prvek můžeš upravit, například nastavit jeho atribut lang.

document.body vrací první přímý potomek kořenového prvku <html>, který je prvkem <body> nebo zastaralým prvkem <frameset>. Všechny tři názvy označují prvky ve jmenném prostoru HTML. Pokud odpovídající potomek chybí nebo kořenem není prvek <html> z HTML, výsledkem je null. Na běžné stránce HTML přidávej obsah do <body>, nikoli přímo do <html>.

Přiřazením nového prvku do document.body nahradíš dosavadní tělo i s jeho podstromem, místo abys do něj přidal obsah. Pokud tělo chybí, setter připojí zadaný prvek ke kořeni. Přiřazení null nebo jiného prvku než HTML prvku <body> či <frameset> nebo pokus o vložení bez kořene vyvolá výjimku DOMException s názvem HierarchyRequestError.

Standard HTML definuje document.body a standard DOM definuje document.documentElement. Ani jedna z těchto vlastností není součástí ECMAScriptu 2024. Prostředí bez DOM stránky nemusí poskytovat globální objekt document. Při zpracování HTML může skript získat kořen dříve, než vznikne <body>. Před použitím ověř, že výsledek není null; na běžné stránce můžeš počkat na DOMContentLoaded, pokud zpracování ještě probíhá.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document body and root</title>
</head>
<body>
  <script>
    {
      const doc = document.implementation.createHTMLDocument();
      const root = doc.documentElement;
      const body = doc.body;

      console.log(`${root.localName} > ${body.localName}`);
      console.log(body.parentElement === root);

      body.remove();
      console.log(doc.body === null);
      console.log(doc.documentElement === root);
    }
  </script>
</body>
</html>

Výsledek

html > body
true
true
true

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a podívej se na výstup v konzoli. Skript vytvoří samostatný dokument HTML, vypíše názvy prvků a ověří vztah mezi rodičem a potomkem. Po odstranění `<body>` vrací `doc.body` hodnotu `null` a kořen zůstává stejným objektem. Otevřená stránka se nezmění.

Související lekce

  • JavaScript · Lekce 32 · Středně pokročilá · Verze: 3

Zdroje