CKTIS / JavaScript
Document.getElementById() i documentElement: pretraživanje po ID-u i korijenski element
`getElementById()` traži element po točnom ID-u, dok `documentElement` daje korijenski element dokumenta. U oba slučaja rezultat može biti `null`, ali iz različitih razloga.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
doc.getElementById(id) // Element or null
doc.documentElement // Element or null; read-onlydoc.getElementById(id) pretražuje trenutačno stablo dokumenta doc. Predaj sam ID, primjerice 'Panel', bez dodavanja prefiksa # iz CSS selektora. Metoda razlikuje velika i mala slova te vraća Element ili null ako nema podudaranja. U HTML-u ID-jevi moraju biti jedinstveni u svojem stablu. Ako postoje duplikati, metoda vraća prvo podudaranje prema redoslijedu u stablu.
Pretraživanje ne obuhvaća elemente koji nisu umetnuti u to stablo ni elemente unutar stabala shadow DOM-a. Ako se skripta izvrši prije umetanja, rezultat može biti null; provjeri ga prije pristupa njegovu svojstvu. Kasniji poziv ponovno pretražuje stablo, ali se spremljena referenca ne mijenja kad se element ukloni.
doc.documentElement je svojstvo samo za čitanje, a ne metoda. Vraća korijenski element bez obzira na njegov ID: html u tipičnom HTML dokumentu ili element koji je korijen u XML-u. To nije ni sam čvor Document ni body. Ako nema korijenskog elementa, vrijednost je null.
Oba su člana dio web API-ja DOM, a ne ECMAScripta 2024. Sama podrška za JavaScript ne jamči dostupnost objekta document.
Primjeri
<!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>Rezultat
html null true null null
Spremi primjer kao datoteku `.html`, otvori je u pregledniku i provjeri ispis u konzoli za razvojne programere. Primjer stvara zaseban HTML dokument i ne mijenja trenutačnu stranicu. `'Panel'` se nalazi tek nakon umetanja, `'panel'` se ne podudara, a novi prazan `Document` nema korijenski element.
Povezane lekcije
- JavaScript · Lekcija 19 · Napredno · Verzija: 4
- JavaScript · Lekcija 33 · Napredno · Verzija: 4