Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 element

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

Źródła