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

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 = newBody

Document.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.

Zdroje