Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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 element

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

Izvori