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 = newBodydocument.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