CKTIS / JavaScript
`document.getElementById()` a `document.body`
Użyj `getElementById()`, aby znaleźć element według identyfikatora, a `document.body`, aby pobrać element reprezentujący treść dokumentu niezależnie od jego identyfikatora.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
document.getElementById(id)
document.body
document.body = newBodydocument.getElementById(id) to metoda, która szuka w drzewie danego dokumentu i zwraca Element albo null. Podaj dokładną wartość atrybutu id, np. "note", a nie selektor CSS "#note". Wielkość liter ma znaczenie. Identyfikatory powinny być unikatowe; przy duplikatach metoda zwraca pierwszy pasujący element w kolejności drzewa. Nie znajduje elementów, których jeszcze nie wstawiono do drzewa dokumentu.
document.body to właściwość odczytywana bez nawiasów. Zwraca pierwszy bezpośredni element potomny głównego elementu HTML html, który jest elementem HTML body lub przestarzałym elementem HTML frameset, albo null, jeśli nie ma takiego elementu. document.getElementById("body") szuka identyfikatora body, a nie znacznika; może zwrócić inny element albo null, nawet gdy document.body istnieje.
Przypisanie do document.body może zastąpić cały dotychczasowy element wraz z jego poddrzewem. Jeśli go nie ma, element zostaje dołączony do elementu głównego dokumentu. Przypisanie null lub elementu innego niż HTML body lub frameset, a także brak elementu głównego dokumentu, powodują DOMException o nazwie HierarchyRequestError.
Podczas parsowania strony null może oznaczać, że potrzebnego węzła jeszcze nie utworzono. W przypadku statycznego HTML wykonaj dostęp po parsowaniu, np. w procedurze obsługi DOMContentLoaded zarejestrowanej przed tym zdarzeniem, i nadal sprawdzaj wynik przed użyciem. To interfejsy webowe, a nie część ECMAScript 2024; zwykły web worker nie ma dostępu do document strony.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM lookup example</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument("DOM demo");
const body = doc.body;
console.log(`Before setting an ID: ${doc.getElementById("body")}`);
body.id = "body";
console.log(`Same node: ${doc.getElementById("body") === body}`);
console.log(`Wrong case: ${doc.getElementById("Body")}`);
const item = doc.createElement("p");
item.id = "note";
console.log(`Before insertion: ${doc.getElementById("note")}`);
body.appendChild(item);
console.log(`After insertion: ${doc.getElementById("note") === item}`);
})();
</script>
</body>
</html>Wynik
Before setting an ID: null Same node: true Wrong case: null Before insertion: null After insertion: true
Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź komunikaty w konsoli. Oddzielny dokument ma już element `body`, ale bez identyfikatora. Po nadaniu mu ID obie formy dostępu zwracają ten sam węzeł. Element `p` staje się wyszukiwalny dopiero po wstawieniu.
Powiązane lekcje
- JavaScript · Lekcja 6 · Zaawansowany · Wersja: 4