Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Document.documentElement — korenski element dokumenta

Document.documentElement vrne korenski element dokumenta ali null. Lastnost je samo za branje, sam element pa je mogoče spreminjati.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

document.documentElement

Document.documentElement preberite na primerku Document, na primer z document.documentElement. Vrne Element, katerega nadrejeno vozlišče je dokument, ali null, če takega elementa ni. Dokument ima lahko največ en tak element.

Razčlenjevalnik HTML običajno ustvari element html kot korenski element dokumenta, vendar DOM ne zahteva tega imena oznake. Če korenski element zamenjate z drugim elementom, na primer z body, lastnost vrne novi element. V XML je njegovo ime odvisno od dokumenta. Te lastnosti ne zamenjujte z firstChild, ki se lahko nanaša na primer na deklaracijo tipa dokumenta.

To, da je lastnost samo za branje, ne pomeni, da vrnjenega elementa ni mogoče spreminjati. Primer odstrani koren ločenega dokumenta XML; naslednje branje vrne null. To je API DOM, ne funkcija jezika ECMAScript.

Primeri

const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);

Rezultat

root
null

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri