CKTIS / JavaScript
`document.body` a `document.documentElement`
Użyj `document.body`, by odwołać się do elementu treści strony, a `document.documentElement`, by odwołać się do elementu głównego dokumentu. Obie właściwości mogą zwrócić `null`.
Wersja: Current web platform; runtime support varies
Składnia
document.body
document.documentElement
document.body = newBodydocument.documentElement zwraca element główny dokumentu albo null, jeśli go nie ma. W zwykłej stronie HTML jest to <html>; w dokumencie XML element główny może mieć inną nazwę. Właściwość jest tylko do odczytu, ale zwrócony element można modyfikować, na przykład ustawiając atrybut lang.
document.body zwraca pierwszy bezpośredni element potomny głównego elementu <html>, który jest elementem <body> albo przestarzałym <frameset>. Wszystkie trzy nazwy odnoszą się do elementów z przestrzeni nazw HTML. Gdy brakuje odpowiedniego elementu potomnego lub głównym elementem nie jest HTML-owy <html>, wynikiem jest null. W zwykłej stronie HTML dodawaj treść do <body>, a nie bezpośrednio do <html>.
Przypisanie nowego elementu do document.body zastępuje istniejący element wraz z jego poddrzewem, zamiast dopisywać do niego treść. Jeśli ciała nie ma, obiekt Document dołącza przekazany element do elementu głównego. Przypisanie null lub elementu innego niż HTML-owy <body> albo <frameset>, jak również próba wstawienia bez elementu głównego, powoduje wyjątek DOMException o nazwie HierarchyRequestError.
Standard HTML definiuje document.body, a standard DOM definiuje document.documentElement. Żadna z tych właściwości nie należy do ECMAScript 2024. Środowisko bez DOM strony może nie udostępniać globalnego document. Skrypt uruchomiony podczas parsowania może zobaczyć element główny, zanim powstanie <body>. Sprawdź, czy wartość nie jest null, zanim jej użyjesz; na zwykłej stronie możesz zaczekać na DOMContentLoaded, jeśli parsowanie jeszcze trwa.
Przykłady
<!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>Wynik
html > body true true true
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź komunikaty w konsoli. Kod tworzy osobny dokument HTML, wypisuje nazwy elementów i sprawdza relację rodzic–dziecko. Po usunięciu `<body>` właściwość `doc.body` zwraca `null`, a element główny pozostaje tym samym obiektem. Otwarta strona się nie zmienia.
Powiązane lekcje
- JavaScript · Lekcja 32 · Średniozaawansowany · Wersja: 3