CKTIS / JavaScript
Razlika med `document.body` in `document.documentElement`
Za dostop do elementa z vsebino strani uporabi `document.body`, za dostop do korenskega elementa dokumenta pa `document.documentElement`. Obe lastnosti lahko vrneta `null`.
Različica: Current web platform; runtime support varies
Sintaksa
document.body
document.documentElement
document.body = newBodydocument.documentElement vrne korenski element dokumenta ali null, če ga ni. Na običajni strani HTML je to <html>; v dokumentu XML ima lahko korenski element drugo ime. Lastnost je samo za branje, vrnjeni element pa lahko spremeniš, na primer tako, da mu nastaviš atribut lang.
document.body vrne prvi neposredni podrejeni element korenskega elementa <html>, ki je <body> ali zastareli <frameset>. Vsa tri imena označujejo elemente v imenskem prostoru HTML. Če takega podrejenega elementa ni ali če koren ni element <html> iz HTML, je rezultat null. Na običajni strani HTML dodajaj vsebino v <body>, ne neposredno v <html>.
Če lastnosti document.body prirediš nov element, ta zamenja obstoječe telo in njegovo poddrevo, namesto da bi telesu dodal vsebino. Če telesa ni, nastavitvena metoda doda podani element h korenu. Prirejanje vrednosti null ali elementa, ki ni HTML-jev <body> ali <frameset>, oziroma poskus vstavljanja brez korena sproži izjemo DOMException z imenom HierarchyRequestError.
Standard HTML določa document.body, standard DOM pa določa document.documentElement. Nobena od teh lastnosti ni del standarda ECMAScript 2024. Izvajalno okolje brez DOM-a strani morda ne ponuja globalnega objekta document. Med razčlenjevanjem HTML-ja lahko skript vidi koren, preden nastane <body>. Pred uporabo preveri, ali je rezultat null; če razčlenjevanje običajne strani še poteka, lahko počakaš na DOMContentLoaded.
Primeri
<!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>Rezultat
html > body true true true
Primer shrani kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli. Skript ustvari ločen dokument HTML, izpiše imeni elementov in preveri razmerje med nadrejenim in podrejenim elementom. Po odstranitvi `<body>` lastnost `doc.body` vrne `null`, koren pa ostane isti objekt. Odprta stran se ne spremeni.
Povezane lekcije
- JavaScript · Lekcija 32 · Srednja · Različica: 3