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

CKTIS / JavaScript

`Document.body` и `Document.title`: съдържание и заглавие на страницата

`document.body` дава достъп до елемента със съдържанието на страницата, а `document.title` позволява да прочетеш или промениш текста на заглавието.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

doc.body              // Read: HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = bodyElement // Write: supply an HTML body or frameset element
 doc.title             // Read: string
 doc.title = titleText // Write: supply title text

Document.body/title е съкратено означение на две свойства от интерфейса Document, а не синтаксис за писане на код. В скрипт на страница document е обектът на текущия документ. Двете свойства са част от API на уеб платформата, а не от ECMAScript 2024. Среда без DOM не е длъжна да предоставя document.

document.body връща първото пряко дете на елемента html, което е body или остарелият елемент frameset. Ако такова дете няма, връща null. Докато HTML се анализира, тялото може още да не е създадено. Провери дали съществува, преди да го използваш, или изпълни кода след анализа, например в обработчик на DOMContentLoaded, регистриран преди настъпването на събитието.

За да добавиш съдържание, без да заменяш целия елемент, използвай document.body.append(node). Присвояването на друг елемент body или frameset заменя съществуващия елемент заедно с неговото поддърво. Ако такъв елемент още няма, новият се вмъква под кореновия елемент на документа. Присвояването на null не премахва тялото, а предизвиква изключение HierarchyRequestError. Същото изключение възниква и ако няма коренов елемент, под който да се вмъкне новият.

document.title връща низ, а не елемент или заглавие h1. При четене празните знаци от ASCII в двата края се премахват, а всяка вътрешна поредица от тях се свежда до един интервал. Ако в HTML няма елемент title, резултатът е празен низ. Присвояването променя текста на заглавието, без да го интерпретира като HTML, и обикновено сменя надписа на раздела на отворената страница. Ако title липсва, но има head, се създава title в head; ако липсват и двата елемента, присвояването няма ефект. Документ с коренов SVG елемент svg използва title от именното пространство на SVG като пряко дете на корена.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.body and Document.title example</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    doc.title = "  Study   notes  ";

    const paragraph = doc.createElement("p");
    paragraph.textContent = "Review the DOM.";
    doc.body.append(paragraph);

    console.log(doc.title);
    console.log(doc.body.textContent);
  </script>
</body>
</html>

Резултат

Study notes
Review the DOM.

Запази примера като файл с разширение `.html`, отвори го в браузър и провери резултата в конзолата на инструментите за разработчици. Скриптът създава отделен документ, затова не променя съдържанието на отворената страница или заглавието на нейния раздел.

Свързани уроци

  • JavaScript · Урок 36 · Средно · Версия: 3

Източници