CKTIS / JavaScript
Vyhľadávanie podľa ID, koreňový prvok a telo dokumentu
Pomocou `getElementById()` vyhľadaj prvok podľa ID, pomocou `documentElement` získaj koreňový prvok a cez `body` pristúp k telu dokumentu HTML. Všetky tri operácie môžu z rôznych dôvodov vrátiť `null`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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) hľadá v strome dokumentu doc. Zadaj presnú hodnotu id bez pridanej predpony #: nejde o selektor CSS a rozlišujú sa veľké a malé písmená. Metóda vráti zodpovedajúci Element alebo null. Identifikátory majú byť jedinečné; pri duplicite sa vráti prvá zhoda v poradí stromu. Vyhľadávanie vynecháva odpojené uzly a nevstupuje do stromov Shadow DOM.
doc.documentElement je len na čítanie: vráti koreňový prvok (<html> v dokumente HTML; v XML to môže byť iný prvok) alebo null, ak koreňový prvok chýba. doc.body vráti prvého priameho potomka prvku <html>, ktorý je typu <body> alebo zastaraného typu <frameset>, prípadne null, ak taký potomok neexistuje. Obe vlastnosti čítaj bez zátvoriek.
Na rozdiel od documentElement sa do body dá priradiť hodnota a nahradiť tak existujúci prvok. Jeho potomkovia sa do nového prvku nepresunú. Priradenie null alebo objektu HTMLElement, ktorý nie je prvkom <body> ani <frameset>, vyvolá HierarchyRequestError. Ak prvok neimplementuje rozhranie HTMLElement, ako napríklad prvok SVG, konverzia podľa Web IDL vyvolá TypeError ešte pred zavolaním settera. Priradenie platného prvku <body> alebo <frameset> tiež vyvolá HierarchyRequestError, ak dokument nemá koreňový prvok.
Počas spracúvania HTML nemusí telo dokumentu ani hľadaný prvok ešte existovať. Ak kód závisí od značiek stránky, pri document.readyState === "loading" počkaj na DOMContentLoaded; inak ho spusti hneď. Pred použitím over, že výsledok nie je null: priame čítanie vlastnosti z null vyvolá TypeError. Tieto API definujú štandardy DOM a HTML, nie ECMAScript. Údaj o verzii ECMAScript 2024 nevypovedá o ich dostupnosti; prostredie JavaScriptu nemusí poskytovať document.
Prí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ýsledok
html body null true null
Ulož príklad ako súbor HTML, otvor ho v prehliadači a pozri sa do vývojárskej konzoly. Samostatný dokument HTML už obsahuje `html` a `body` a nemení stránku, na ktorej skript beží. `Panel` sa nájde až po vložení; `panel` sa nezhoduje pre rozdiel medzi veľkým a malým písmenom.
Súvisiace lekcie
- JavaScript · Lekcia 37 · Pokročilá · Verzia: 4