База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Разлика между `document.body` и `document.documentElement`

Използвай `document.body` за достъп до елемента със съдържанието на страницата, а `document.documentElement` — за достъп до кореновия елемент на документа. И двете свойства могат да върнат `null`.

Версия: Current web platform; runtime support varies

Синтаксис

document.body
 document.documentElement
 document.body = newBody

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

Източници