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