Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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 element

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

Zdroje