Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

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

Zdroje