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

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.

Zdroje