CKTIS / JavaScript
Pretraživanje po ID-u, korijenski element i tijelo dokumenta
Pomoću `getElementById()` pronađi element po ID-u, pomoću `documentElement` dohvati korijenski element, a pomoću `body` pristupi tijelu HTML dokumenta. Sve tri operacije mogu vratiti `null` iz različitih razloga.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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) pretražuje stablo dokumenta doc. Proslijedi točnu vrijednost id bez dodanog prefiksa #: to nije CSS selektor, a velika i mala slova se razlikuju. Metoda vraća odgovarajući Element ili null. ID-jevi trebaju biti jedinstveni; kod ponavljanja se vraća prvi rezultat prema redoslijedu u stablu. Pretraživanje preskače odvojene čvorove i ne ulazi u stabla Shadow DOM-a.
doc.documentElement je svojstvo samo za čitanje: vraća korijenski element (<html> u HTML dokumentu; u XML-u to može biti drugi element) ili null ako ga nema. doc.body vraća prvo neposredno dijete elementa <html> koje je <body> ili zastarjeli <frameset>, odnosno null ako takvog djeteta nema. Oba svojstva čitaj bez zagrada.
Za razliku od documentElement, svojstvu body možeš dodijeliti vrijednost i tako zamijeniti postojeći element. Njegova se djeca ne premještaju u novi element. Dodjela vrijednosti null ili objekta HTMLElement koji nije ni <body> ni <frameset> izaziva HierarchyRequestError. Ako element ne implementira sučelje HTMLElement, kao što je slučaj sa SVG elementom, pretvorba prema pravilima Web IDL-a izaziva TypeError prije poziva settera. Dodjela valjanog elementa <body> ili <frameset> također izaziva HierarchyRequestError ako dokument nema korijenski element.
Tijekom raščlambe HTML-a tijelo dokumenta ili traženi element možda još ne postoji. Ako kôd ovisi o oznakama stranice, pričekaj DOMContentLoaded kada vrijedi document.readyState === "loading"; u suprotnom ga pokreni odmah. Prije uporabe provjeri da rezultat nije null: izravno čitanje svojstva vrijednosti null izaziva TypeError. Te API-je definiraju standardi DOM i HTML, a ne ECMAScript. Oznaka verzije ECMAScript 2024 ne govori jesu li dostupni; izvršno okruženje za JavaScript ne mora imati document.
Primjeri
<!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>Rezultat
html body null true null
Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri konzolu za razvojne programere. Zasebni HTML dokument već sadrži `html` i `body` te ne mijenja stranicu na kojoj se skripta izvršava. `Panel` se pronalazi tek nakon umetanja; `panel` se ne podudara zbog razlike između velikog i malog slova.
Povezane lekcije
- JavaScript · Lekcija 37 · Napredno · Verzija: 4