CKTIS / JavaScript
Document.getElementById() a documentElement: hledání podle ID a kořenový prvek
`getElementById()` hledá prvek podle přesné hodnoty ID, zatímco `documentElement` poskytuje kořenový prvek dokumentu. Oba mohou vrátit `null`, ale z různých důvodů.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
doc.getElementById(id) // Element or null
doc.documentElement // Element or null; read-onlydoc.getElementById(id) prohledává aktuální strom dokumentu doc. Předej samotné ID, například 'Panel', bez přidání předpony # používané v selektorech CSS. Metoda rozlišuje velká a malá písmena a vrací Element, nebo null, pokud nic nenajde. ID v HTML musí být v rámci svého stromu jedinečná. Při duplicitě metoda vrátí první shodu v pořadí stromu.
Hledání nezahrnuje prvky, které nejsou do daného stromu vloženy, ani prvky uvnitř stromů shadow DOM. Pokud se skript spustí před vložením prvku, výsledkem může být null. Než přistoupíš k vlastnosti výsledku, zkontroluj ho. Pozdější volání hledá znovu, ale uložená reference se při odebrání prvku nezmění.
doc.documentElement je vlastnost pouze pro čtení, ne metoda. Vrací kořenový prvek bez ohledu na jeho ID: v běžném dokumentu HTML html, v XML prvek, který je kořenem. Nejde o samotný uzel Document ani o body. Pokud kořenový prvek neexistuje, má vlastnost hodnotu null.
Oba členy patří do webového rozhraní DOM, nikoli do ECMAScriptu 2024. Samotná podpora JavaScriptu nezaručuje dostupnost document.
Příklady
<!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>Výsledek
html null true null null
Ulož příklad jako soubor `.html`, otevři ho v prohlížeči a zkontroluj výstup v konzoli pro vývojáře. Příklad vytvoří samostatný dokument HTML a aktuální stránku nezmění. `'Panel'` se najde až po vložení, `'panel'` se neshoduje a nový prázdný `Document` nemá kořenový prvek.
Související lekce
- JavaScript · Lekce 19 · Pokročilá · Verze: 4
- JavaScript · Lekce 33 · Pokročilá · Verze: 4