CKTIS / JavaScript
`Document.body` i `Document.title`: treść i tytuł dokumentu
`document.body` zwraca element z treścią strony, a `document.title` pozwala odczytać lub ustawić tekst tytułu dokumentu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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 to skrót oznaczający dwie właściwości interfejsu Document, a nie zapis do użycia w kodzie. W skrypcie strony document to obiekt bieżącego dokumentu. Obie właściwości należą do interfejsów API platformy webowej, a nie do ECMAScript 2024. Środowisko bez DOM nie musi udostępniać obiektu document.
document.body zwraca pierwsze bezpośrednie dziecko elementu html będące elementem body lub przestarzałym elementem frameset. Gdy takiego dziecka nie ma, zwraca null. Skrypt uruchomiony podczas parsowania może jeszcze nie zastać elementu body: przed użyciem sprawdź, czy istnieje, albo uruchom kod po zakończeniu parsowania, np. w procedurze obsługi DOMContentLoaded zarejestrowanej przed tym zdarzeniem.
Aby dodać treść bez wymiany całego elementu, użyj document.body.append(node). Przypisanie innego elementu body lub frameset zastępuje dotychczasowy element wraz z jego poddrzewem, a gdy takiego elementu jeszcze nie ma, wstawia nowy do elementu głównego dokumentu. Przypisanie null nie usuwa treści: powoduje wyjątek HierarchyRequestError. Ten wyjątek wystąpi też, jeśli dokument nie ma elementu głównego, do którego można wstawić nowy element.
document.title zwraca ciąg znaków, nie element ani nagłówek h1. Przy odczycie usuwa skrajne białe znaki ASCII i zastępuje ich wewnętrzne ciągi pojedynczą spacją. W HTML brak elementu title oznacza pusty ciąg. Przypisanie zmienia tekst tytułu, nie interpretuje go jako HTML i zwykle zmienia etykietę karty otwartej strony. Jeśli title nie istnieje, ale jest head, tytuł zostanie utworzony w head; jeśli brakuje obu, przypisanie nie ma skutku. W dokumencie z głównym elementem svg używany jest osobny element title w przestrzeni nazw SVG, bezpośrednio pod svg.
Przykłady
<!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>Wynik
Study notes Review the DOM.
Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź wynik w konsoli narzędzi deweloperskich. Skrypt tworzy osobny dokument, więc nie zmienia treści otwartej strony ani tytułu jej karty.
Powiązane lekcje
- JavaScript · Lekcja 36 · Średniozaawansowany · Wersja: 3