Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Document.getElementById() in documentElement: iskanje po ID-ju in korenski element

`getElementById()` poišče element po njegovem točnem ID-ju, `documentElement` pa poda korenski element dokumenta. Rezultat je lahko v obeh primerih `null`, vendar iz različnih razlogov.

Različica: 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) išče po trenutnem drevesu dokumenta doc. Podaj sam ID, na primer 'Panel', brez dodajanja predpone # iz izbirnika CSS. Metoda razlikuje med velikimi in malimi črkami ter vrne Element ali null, če ni zadetka. V HTML-ju morajo biti ID-ji znotraj svojega drevesa enolični. Če se ID ponovi, metoda vrne prvi zadetek po vrstnem redu v drevesu.

Iskanje ne zajame elementov, ki niso vstavljeni v to drevo, niti elementov v drevesih shadow DOM. Če se skript izvede pred vstavitvijo elementa, je lahko rezultat null; preveri ga, preden dostopaš do njegove lastnosti. Poznejši klic ponovi iskanje, vendar se shranjeni sklic ob odstranitvi elementa ne spremeni.

doc.documentElement je lastnost samo za branje, ne metoda. Poda korenski element ne glede na njegov ID: html v običajnem dokumentu HTML ali element, ki je koren v XML-ju. To ni ne samo vozlišče Document ne body. Če korenskega elementa ni, je vrednost null.

Oba člana sta del spletnega vmesnika DOM, ne ECMAScripta 2024. Sama podpora za JavaScript še ne zagotavlja, da je document na voljo.

Primeri

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

Shrani primer kot datoteko `.html`, odpri jo v brskalniku in preveri izpis v konzoli za razvijalce. Primer ustvari ločen dokument HTML in ne spremeni trenutne strani. `'Panel'` se najde šele po vstavitvi, `'panel'` se ne ujema, nov prazen `Document` pa nima korenskega elementa.

Povezane lekcije

  • JavaScript · Lekcija 19 · Napredna · Različica: 4
  • JavaScript · Lekcija 33 · Napredna · Različica: 4

Viri