CKTIS / JavaScript
Wyszukiwanie po ID, element główny i treść dokumentu
Użyj `getElementById()` do wyszukania elementu po ID, `documentElement` do pobrania elementu głównego dokumentu, a `body` do uzyskania dostępu do jego treści HTML. Te trzy operacje zwracają `null` z różnych powodów.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
doc.getElementById(id) // id: string; returns Element or null
doc.documentElement // read-only; returns Element or null
doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
doc.body = newBody // assigns an HTML body or frameset elementdoc.getElementById(id) szuka w drzewie dokumentu doc. Podaj dokładną wartość id, bez dodawania prefiksu #: nie jest to selektor CSS, a wielkość liter ma znaczenie. Metoda zwraca pasujący Element lub null. Identyfikatory powinny być unikatowe; przy duplikatach wygrywa pierwszy element w kolejności drzewa. Wyszukiwanie pomija odłączone węzły i nie wchodzi do drzew Shadow DOM.
doc.documentElement to właściwość tylko do odczytu: zwraca element główny dokumentu (<html> w dokumencie HTML; w XML może to być inny element) albo null, jeśli go nie ma. doc.body zwraca pierwsze bezpośrednie dziecko elementu <html>, które jest elementem <body> lub przestarzałym <frameset>, albo null, jeśli takiego dziecka nie ma. Obie właściwości odczytuje się bez nawiasów.
W przeciwieństwie do documentElement właściwość body pozwala zastąpić istniejący element: jego dzieci nie są przenoszone do nowego. Przypisanie null lub obiektu HTMLElement, który nie jest elementem <body> ani <frameset>, powoduje HierarchyRequestError. Jeśli przypisywany element nie implementuje HTMLElement (na przykład jest elementem SVG), konwersja Web IDL zgłasza TypeError, zanim setter zostanie wywołany. Przypisanie poprawnego elementu <body> lub <frameset> również powoduje HierarchyRequestError, jeśli dokument nie ma elementu głównego.
Podczas parsowania body lub szukany element mogą jeszcze nie istnieć. Jeśli zależysz od znaczników strony, zaczekaj na DOMContentLoaded, gdy document.readyState === "loading"; w przeciwnym razie uruchom kod od razu. Przed użyciem wyniku sprawdź, czy nie jest null: bezpośredni odczyt właściwości z null powoduje TypeError. Te interfejsy definiują standardy DOM i HTML, a nie ECMAScript. Oznaczenie ECMAScript 2024 nie mówi nic o ich dostępności; nie zakładaj, że środowisko JavaScript udostępnia document.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document lookup demo</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument("Demo");
const panel = doc.createElement("section");
panel.id = "Panel";
console.log(doc.documentElement.localName);
console.log(doc.body.localName);
console.log(doc.getElementById("Panel"));
doc.body.appendChild(panel);
console.log(doc.getElementById("Panel") === panel);
console.log(doc.getElementById("panel"));
</script>
</body>
</html>Wynik
html body null true null
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź konsolę. Osobny dokument HTML ma już elementy `html` i `body` i nie zmienia strony, na której działa skrypt. `Panel` zostaje znaleziony dopiero po wstawieniu, a `panel` nie pasuje z powodu innej wielkości liter.
Powiązane lekcje
- JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4