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