Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Razlika između `document.body` i `document.documentElement`

Upotrijebi `document.body` za pristup elementu sa sadržajem stranice, a `document.documentElement` za pristup korijenskom elementu dokumenta. Oba svojstva mogu vratiti `null`.

Verzija: Current web platform; runtime support varies

Sintaksa

document.body
 document.documentElement
 document.body = newBody

document.documentElement vraća korijenski element dokumenta ili null ako ga nema. Na uobičajenoj HTML stranici to je <html>; u XML dokumentu korijenski element može imati drugo ime. Svojstvo je samo za čitanje, ali vraćeni element možeš mijenjati, primjerice postavljanjem atributa lang.

document.body vraća prvo izravno dijete korijenskog elementa <html> koje je <body> ili zastarjeli <frameset>. Sva tri naziva odnose se na elemente u imenskom prostoru HTML. Ako nema odgovarajućeg djeteta ili korijen nije HTML element <html>, rezultat je null. Na uobičajenoj HTML stranici dodaj sadržaj u <body>, a ne izravno u <html>.

Dodjelom novog elementa svojstvu document.body zamjenjuješ postojeće tijelo i njegovo podstablo umjesto da tijelu dodaješ sadržaj. Ako tijela nema, setter dodaje zadani element korijenu. Dodjela vrijednosti null ili elementa koji nije HTML-ov <body> ili <frameset>, odnosno pokušaj umetanja bez korijena, izaziva iznimku DOMException naziva HierarchyRequestError.

Standard HTML definira document.body, a standard DOM definira document.documentElement. Nijedno od tih svojstava nije dio standarda ECMAScript 2024. Izvršno okruženje bez DOM-a stranice možda ne nudi globalni objekt document. Tijekom raščlambe HTML-a skripta može pristupiti korijenu prije nego što nastane <body>. Prije uporabe provjeri je li rezultat null; ako raščlamba uobičajene stranice još traje, možeš pričekati DOMContentLoaded.

Primjeri

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

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli. Skripta stvara zaseban HTML dokument, ispisuje nazive elemenata i provjerava odnos roditelja i djeteta. Nakon uklanjanja elementa `<body>`, `doc.body` vraća `null`, a korijen ostaje isti objekt. Otvorena stranica ne mijenja se.

Povezane lekcije

  • JavaScript · Lekcija 32 · Srednje · Verzija: 3

Izvori