Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Rozdiel medzi `document.body` a `document.documentElement`

Cez `document.body` získaš prvok s obsahom stránky, cez `document.documentElement` koreňový prvok dokumentu. Obe vlastnosti môžu vrátiť `null`.

Verzia: Current web platform; runtime support varies

Syntax

document.body
 document.documentElement
 document.body = newBody

document.documentElement vracia koreňový prvok dokumentu alebo null, ak žiadny neexistuje. Na bežnej stránke HTML je to <html>; v dokumente XML môže mať koreňový prvok iný názov. Vlastnosť je len na čítanie, ale vrátený prvok môžeš upraviť, napríklad nastaviť jeho atribút lang.

document.body vracia prvého priameho potomka koreňového prvku <html>, ktorý je prvkom <body> alebo zastaraným prvkom <frameset>. Všetky tri názvy označujú prvky v mennom priestore HTML. Ak zodpovedajúci potomok chýba alebo koreň nie je prvkom <html> z HTML, výsledkom je null. Na bežnej stránke HTML pridávaj obsah do <body>, nie priamo do <html>.

Priradením nového prvku do document.body nahradíš existujúce telo aj s jeho podstromom namiesto toho, aby si doň pridal obsah. Ak telo chýba, setter pripojí zadaný prvok ku koreňu. Priradenie null alebo iného prvku než HTML prvku <body> či <frameset>, prípadne pokus o vloženie bez koreňa, vyvolá výnimku DOMException s názvom HierarchyRequestError.

Štandard HTML definuje document.body a štandard DOM definuje document.documentElement. Ani jedna z týchto vlastností nie je súčasťou ECMAScriptu 2024. Prostredie bez DOM stránky nemusí poskytovať globálny objekt document. Pri spracúvaní HTML môže skript získať koreň skôr, ako vznikne <body>. Pred použitím over, že výsledok nie je null; na bežnej stránke môžeš počkať na DOMContentLoaded, ak spracúvanie ešte prebieha.

Príklady

<!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>

Výsledok

html > body
true
true
true

Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup v konzole. Skript vytvorí samostatný dokument HTML, vypíše názvy prvkov a overí vzťah medzi rodičom a potomkom. Po odstránení `<body>` vracia `doc.body` hodnotu `null` a koreň zostáva tým istým objektom. Otvorená stránka sa nezmení.

Súvisiace lekcie

  • JavaScript · Lekcia 32 · Stredne pokročilá · Verzia: 3

Zdroje