Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Document.getElementById() i documentElement: wyszukiwanie po ID a element główny

`getElementById()` wyszukuje element po dokładnej wartości ID, a `documentElement` zwraca element główny dokumentu. Oba mogą dać `null`, ale z różnych powodów.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

doc.getElementById(id) // Element or null
doc.documentElement    // Element or null; read-only

doc.getElementById(id) przeszukuje aktualne drzewo dokumentu doc. Podaj samą wartość id, np. 'Panel', bez dodawania prefiksu # używanego w selektorach CSS. Metoda rozróżnia wielkie i małe litery i zwraca Element lub null, jeśli nie ma dopasowania. W HTML wartości id muszą być unikatowe w obrębie drzewa; przy duplikatach metoda zwraca pierwszy pasujący element w kolejności drzewa.

Wyszukiwanie nie obejmuje elementów niewstawionych do tego drzewa ani elementów wewnątrz drzew shadow DOM. Jeśli skrypt działa przed wstawieniem elementu, wynik może być null; sprawdź go, zanim odczytasz z niego właściwość. Późniejsze wywołanie przeszukuje drzewo ponownie, ale zapisana wcześniej referencja nie zmienia się po usunięciu elementu.

doc.documentElement to właściwość tylko do odczytu, a nie metoda. Zwraca element główny niezależnie od jego ID: html w typowym dokumencie HTML, a w XML dowolny element pełniący tę rolę. Nie jest to sam węzeł Document ani body. Brak elementu głównego oznacza null.

Oba człony należą do webowego API DOM, a nie do ECMAScript 2024. Sama obsługa JavaScriptu nie gwarantuje dostępności document.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document ID lookup and root element</title>
</head>
<body>
  <script>
    (() => {
      const doc = document.implementation.createHTMLDocument('Demo');
      const panel = doc.createElement('div');
      panel.id = 'Panel';

      console.log(doc.documentElement.localName);
      console.log(doc.getElementById('Panel'));
      doc.body.appendChild(panel);
      console.log(doc.getElementById('Panel') === panel);
      console.log(doc.getElementById('panel'));
      console.log(new Document().documentElement);
    })();
  </script>
</body>
</html>

Wynik

html
null
true
null
null

Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź wyniki w konsoli deweloperskiej. Przykład tworzy osobny dokument HTML i nie zmienia bieżącej strony. `'Panel'` zostaje znaleziony dopiero po wstawieniu, `'panel'` nie pasuje, a nowy pusty `Document` nie ma elementu głównego.

Powiązane lekcje

  • JavaScript · Lekcja 19 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4

Źródła