CKTIS / JavaScript
Document.documentElement — koreňový element dokumentu
Document.documentElement vracia koreňový element dokumentu alebo null. Vlastnosť je iba na čítanie, samotný element však možno upravovať.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
document.documentElementČítajte Document.documentElement na inštancii Document, napríklad pomocou document.documentElement. Vracia Element, ktorého rodičom je dokument, alebo null, ak taký element neexistuje. Dokument môže mať najviac jeden takýto element.
Analyzátor HTML zvyčajne vytvorí element html ako koreňový element dokumentu, DOM však tento názov značky nevyžaduje. Ak koreňový element nahradíte iným elementom, napríklad body, vlastnosť vráti nový element. V XML závisí jeho názov od dokumentu. Nezamieňajte túto vlastnosť s firstChild, ktorý môže odkazovať napríklad na deklaráciu typu dokumentu.
To, že je vlastnosť iba na čítanie, neznamená, že vrátený element nemožno meniť. Príklad odstráni koreň samostatného dokumentu XML; pri ďalšom čítaní sa vráti null. Ide o API DOM, nie o funkciu jazyka ECMAScript.
Príklady
const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);Výsledok
root null
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.