CKTIS / JavaScript
`document.getElementById()` a `document.body`: jaký je rozdíl?
Metodou `getElementById()` vyhledáš prvek podle jeho identifikátoru. Vlastnost `document.body` poskytuje přístup k tělu dokumentu bez ohledu na jeho identifikátor.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
document.getElementById(id)
document.body
document.body = newBodydocument.getElementById(id) prohledá strom daného dokumentu a vrátí Element nebo null. Předej přesnou hodnotu id, například "note", nikoli selektor CSS jako "#note". Rozlišují se malá a velká písmena. Identifikátory mají být jedinečné; při duplicitách metoda vrátí první shodu v pořadí stromu. Prvky, které ještě nejsou vložené do stromu dokumentu, nenajde.
Vlastnost document.body čti bez závorek. Vrátí prvního přímého potomka kořenového prvku HTML html, který je prvkem HTML body nebo zastaralým prvkem HTML frameset, případně null, pokud takový prvek neexistuje. document.getElementById("body") hledá identifikátor body, nikoli značku. Může vrátit jiný prvek nebo null, i když document.body existuje.
Přiřazením do document.body lze nahradit celý stávající uzel těla včetně jeho podstromu. Pokud tělo neexistuje, nový prvek se připojí ke kořenovému prvku dokumentu. Přiřazení hodnoty null nebo jiného prvku než HTML body či frameset nebo přiřazení do dokumentu bez kořenového prvku vyvolá DOMException s názvem HierarchyRequestError.
Během zpracování stránky může null znamenat, že uzel ještě nevznikl. U statického HTML k němu přistup až po zpracování, například v obsluze události DOMContentLoaded zaregistrované před jejím vyvoláním, a před použitím výsledek přesto ověř. Jde o API webové platformy, ne o součást ECMAScriptu 2024; běžný web worker nemá přístup k document stránky.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM lookup example</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument("DOM demo");
const body = doc.body;
console.log(`Before setting an ID: ${doc.getElementById("body")}`);
body.id = "body";
console.log(`Same node: ${doc.getElementById("body") === body}`);
console.log(`Wrong case: ${doc.getElementById("Body")}`);
const item = doc.createElement("p");
item.id = "note";
console.log(`Before insertion: ${doc.getElementById("note")}`);
body.appendChild(item);
console.log(`After insertion: ${doc.getElementById("note") === item}`);
})();
</script>
</body>
</html>Výsledek
Before setting an ID: null Same node: true Wrong case: null Before insertion: null After insertion: true
Ulož příklad jako soubor `.html`, otevři ho v prohlížeči a zkontroluj zprávy v konzoli. Samostatný dokument už má prvek `body`, ale bez identifikátoru. Po jeho nastavení oba způsoby přístupu vrátí stejný uzel. Prvek `p` lze najít až po vložení.
Související lekce
- JavaScript · Lekce 6 · Pokročilá · Verze: 4