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