CKTIS / JavaScript
Разлика между `document.body` и `document.documentElement`
Използвай `document.body` за достъп до елемента със съдържанието на страницата, а `document.documentElement` — за достъп до кореновия елемент на документа. И двете свойства могат да върнат `null`.
Версия: Current web platform; runtime support varies
Синтаксис
document.body
document.documentElement
document.body = newBodydocument.documentElement връща кореновия елемент на документа или null, ако няма такъв. В обикновена HTML страница това е <html>; в XML документ кореновият елемент може да има друго име. Свойството е само за четене, но можеш да променяш върнатия елемент, например като зададеш неговия атрибут lang.
document.body връща първия пряк наследник на кореновия елемент <html>, който е <body> или остарелият <frameset>. И трите имена обозначават елементи от именното пространство на HTML. Ако няма подходящ пряк наследник или коренът не е HTML елементът <html>, резултатът е null. В обикновена HTML страница добавяй съдържанието в <body>, а не директно в <html>.
Присвояването на нов елемент на document.body заменя съществуващото тяло заедно с поддървото му, вместо да добавя съдържание в него. Ако няма тяло, setter-ът добавя подадения елемент към корена. Присвояването на null или на елемент, различен от HTML елементите <body> и <frameset>, както и опитът за вмъкване без коренов елемент, предизвикват изключение DOMException с име HierarchyRequestError.
Стандартът HTML определя document.body, а стандартът DOM определя document.documentElement. Нито едно от двете свойства не е част от ECMAScript 2024. Среда за изпълнение без DOM на страница може да не предоставя глобалния обект document. Докато браузърът обработва HTML, скриптът може да види корена, преди да е създаден <body>. Преди употреба провери дали резултатът е null; ако обработката на обикновена страница още не е завършила, можеш да изчакаш DOMContentLoaded.
Примери
<!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>Резултат
html > body true true true
Запази примера като HTML файл, отвори го в браузър и провери съобщенията в конзолата. Кодът създава отделен HTML документ, извежда имената на елементите и проверява връзката родител–дете. След премахването на `<body>` свойството `doc.body` връща `null`, а коренът остава същият обект. Отворената страница не се променя.
Свързани уроци
- JavaScript · Урок 32 · Средно · Версия: 3