CKTIS / JavaScript
Document.body – prístup k prvku body dokumentu
Document.body je vlastnosť webového API prístupná ako document.body. Vráti prvok body, zastaraný prvok frameset alebo null. Priradenie nahradí celý prvok, nielen jeho obsah.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
document.body
document.body = newBodyDocument.body je vlastnosť rozhrania Document, prístupná ako document.body. Vráti prvý priamy podradený prvok koreňového prvku dokumentu, ktorý je prvkom body alebo frameset v mennom priestore HTML. Ak taký podradený prvok neexistuje, vráti null. Samotný koreňový prvok nemusí byť prvkom html. Nevracia text ani kópiu prvku.
Pred použitím počítajte s možnosťou, že výsledok bude null, napríklad ak parser ešte nevytvoril prvok body. Ide o webové API definované v HTML Standard, nie o súčasť samotného ECMAScriptu. Verzia Node v repozitári nepotvrdzuje dostupnosť tohto API prehliadača.
Priradenie document.body = newBody nahradí existujúci prvok aj jeho podstrom; starý obsah sa nekopíruje. Priradenie toho istého prvku nič nezmení. Ak prvok body chýba, nový prvok sa pripojí ku koreňovému prvku. Chýbajúci koreňový prvok alebo priradenie null či prvku div spôsobí DOMException HierarchyRequestError: prijímajú sa prvky body a frameset.
Príklad pracuje so samostatným dokumentom. Ukazuje nahradenie prvku a odpojenie predchádzajúceho bez zmeny zobrazenej stránky.
Príklady
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);Výsledok
true After true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.