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

CKTIS / JavaScript

Document.body – dostop do elementa body dokumenta

Document.body je lastnost spletnega API-ja, dostopna kot document.body. Vrne element body, zastareli element frameset ali null. Dodelitev zamenja celoten element, ne le njegove vsebine.

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.body
document.body = newBody

Document.body je lastnost vmesnika Document, dostopna kot document.body. Vrne prvi neposredni podrejeni element korenskega elementa dokumenta, ki je element body ali frameset v imenskem prostoru HTML. Če takega podrejenega elementa ni, vrne null. Ni nujno, da je korenski element sam element html. Ne vrne besedila ali kopije elementa.

Pred uporabo upoštevajte možnost, da je rezultat null, na primer če razčlenjevalnik še ni ustvaril elementa body. To je spletni API, določen v HTML Standard, in ne funkcija samega ECMAScripta. Različica Node v repozitoriju ne potrjuje, da je ta brskalniški API na voljo.

Dodelitev document.body = newBody zamenja obstoječi element in njegovo poddrevo; stare vsebine ne kopira. Dodelitev istega elementa ne povzroči sprememb. Če element body manjka, se novi element doda korenskemu elementu. Če manjka korenski element ali se dodeli null oziroma element div, pride do izjeme DOMException HierarchyRequestError: sprejeti so elementi body in frameset.

Primer deluje z ločenim dokumentom. Prikazuje zamenjavo elementa in odklop prejšnjega, ne da bi spremenil prikazano stran.

Primeri

const doc = document.implementation.createHTMLDocument("");
const original = doc.body;
original.textContent = "Before";

const replacement = doc.createElement("body");
replacement.textContent = "After";
doc.body = replacement;

console.log(doc.body === replacement);
console.log(doc.body.textContent);
console.log(original.parentNode === null);

Rezultat

true
After
true

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

Viri