CKTIS / JavaScript
Document.getElementById() a documentElement: vyhľadávanie podľa ID a koreňový prvok
`getElementById()` hľadá prvok podľa presnej hodnoty ID, kým `documentElement` poskytuje koreňový prvok dokumentu. Obe môžu poskytnúť hodnotu `null`, ale z rôznych dôvodov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
doc.getElementById(id) // Element or null
doc.documentElement // Element or null; read-onlydoc.getElementById(id) prehľadáva aktuálny strom dokumentu doc. Odovzdaj samotné ID, napríklad 'Panel', bez pridania predpony # používanej v selektoroch CSS. Metóda rozlišuje veľké a malé písmená a vráti Element alebo null, ak nič nenájde. ID v HTML musia byť v rámci svojho stromu jedinečné. Pri duplicite metóda vráti prvú zhodu v poradí stromu.
Vyhľadávanie nezahŕňa prvky, ktoré nie sú vložené do daného stromu, ani prvky vnútri stromov shadow DOM. Ak sa skript spustí pred vložením prvku, výsledkom môže byť null. Skontroluj ho skôr, než pristúpiš k jeho vlastnosti. Neskoršie volanie hľadá znova, ale uložená referencia sa po odstránení prvku nezmení.
doc.documentElement je vlastnosť iba na čítanie, nie metóda. Vracia koreňový prvok bez ohľadu na jeho ID: html v typickom dokumente HTML alebo prvok, ktorý je koreňom v XML. Nie je to samotný uzol Document ani body. Ak koreňový prvok neexistuje, hodnota je null.
Oba členy patria do webového rozhrania DOM, nie do ECMAScriptu 2024. Samotná podpora JavaScriptu nezaručuje dostupnosť document.
Prí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ýsledok
html null true null null
Ulož príklad ako súbor `.html`, otvor ho v prehliadači a skontroluj výstup v konzole pre vývojárov. Príklad vytvorí samostatný dokument HTML a aktuálnu stránku nezmení. `'Panel'` sa nájde až po vložení, `'panel'` sa nezhoduje a nový prázdny `Document` nemá koreňový prvok.
Súvisiace lekcie
- JavaScript · Lekcia 19 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 33 · Pokročilá · Verzia: 4