CKTIS / JavaScript
Document.documentElement — kořenový element dokumentu
Document.documentElement vrací kořenový element dokumentu, nebo null. Vlastnost je pouze pro čtení, samotný element však lze upravovat.
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.documentElementČtěte Document.documentElement na instanci Document, například pomocí document.documentElement. Vrací Element, jehož rodičem je dokument, nebo null, pokud žádný takový element neexistuje. Dokument může mít nejvýše jeden takový element.
Analyzátor HTML obvykle vytvoří element html jako kořenový element dokumentu, DOM však tento název značky nevyžaduje. Pokud kořenový element nahradíte jiným elementem, například body, vlastnost vrátí nový element. V XML závisí jeho název na dokumentu. Nezaměňujte tuto vlastnost s firstChild, který může odkazovat například na deklaraci typu dokumentu.
To, že je vlastnost pouze pro čtení, neznamená, že vrácený element nelze měnit. Příklad odstraní kořen samostatného dokumentu XML; při dalším čtení se vrátí null. Jde o API DOM, nikoli o funkci jazyka ECMAScript.
Příklady
const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);Výsledek
root null
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.