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

CKTIS / JavaScript

Vyhledávání podle ID, kořenový element a tělo dokumentu

Pomocí `getElementById()` vyhledej element podle ID, pomocí `documentElement` získej kořenový element a přes `body` přistup k tělu dokumentu HTML. Všechny tři přístupy mohou z různých důvodů vrátit `null`.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

doc.getElementById(id) // id: string; returns Element or null
 doc.documentElement // read-only; returns Element or null
 doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = newBody // assigns an HTML body or frameset element

doc.getElementById(id) hledá ve stromu dokumentu doc. Zadej přesnou hodnotu id bez přidané předpony #: nejde o selektor CSS a rozlišují se velká a malá písmena. Metoda vrací odpovídající Element nebo null. ID mají být jedinečná; při duplicitě se vrátí první shoda v pořadí stromu. Vyhledávání vynechává odpojené uzly a nevstupuje do stromů Shadow DOM.

doc.documentElement je jen pro čtení: vrací kořenový element (<html> v dokumentu HTML; v XML to může být jiný element) nebo null, pokud kořenový element chybí. doc.body vrací prvního přímého potomka elementu <html>, který je typu <body> nebo zastaralého typu <frameset>, případně null, pokud takový potomek není. Obě vlastnosti čti bez závorek.

Na rozdíl od documentElement lze do body přiřadit hodnotu a nahradit tak stávající element. Jeho potomci se do nového elementu nepřesunou. Přiřazení null nebo objektu HTMLElement, který není elementem <body> ani <frameset>, vyvolá HierarchyRequestError. Pokud element neimplementuje rozhraní HTMLElement, jako je tomu u elementu SVG, převod podle Web IDL vyvolá TypeError ještě před zavoláním setteru. Přiřazení platného elementu <body> nebo <frameset> také vyvolá HierarchyRequestError, pokud dokument nemá kořenový element.

Během zpracování HTML nemusí tělo dokumentu ani hledaný element ještě existovat. Pokud kód potřebuje značky stránky, při document.readyState === "loading" počkej na DOMContentLoaded; jinak ho spusť hned. Před použitím ověř, že výsledek není null: přímé čtení vlastnosti z null vyvolá TypeError. Tato API definují standardy DOM a HTML, nikoli ECMAScript. Údaj o verzi ECMAScript 2024 nevypovídá o jejich dostupnosti; prostředí JavaScriptu nemusí poskytovat document.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document lookup demo</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument("Demo");
    const panel = doc.createElement("section");
    panel.id = "Panel";

    console.log(doc.documentElement.localName);
    console.log(doc.body.localName);
    console.log(doc.getElementById("Panel"));

    doc.body.appendChild(panel);
    console.log(doc.getElementById("Panel") === panel);
    console.log(doc.getElementById("panel"));
  </script>
</body>
</html>

Výsledek

html
body
null
true
null

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a podívej se do vývojářské konzole. Samostatný dokument HTML už obsahuje `html` a `body` a nemění stránku, na které skript běží. `Panel` se najde až po vložení; `panel` se neshoduje kvůli rozdílu mezi velkým a malým písmenem.

Související lekce

  • JavaScript · Lekce 37 · Pokročilá · Verze: 4

Zdroje