Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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-only

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

Izvori