Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Iskanje po ID-ju, korenski element in telo dokumenta

Z `getElementById()` poiščeš element po ID-ju, z `documentElement` dobiš korenski element, z `body` pa dostopaš do telesa dokumenta HTML. Vsi trije dostopi lahko iz različnih razlogov vrnejo `null`.

Različica: 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) išče po drevesu dokumenta doc. Podaj točno vrednost id, ne da bi ji dodal predpono #: to ni izbirnik CSS in velike ter male črke se razlikujejo. Metoda vrne ustrezen Element ali null. ID-ji naj bodo enolični; pri podvojenih vrednostih se vrne prvi zadetek po vrstnem redu v drevesu. Iskanje izpusti odklopljena vozlišča in ne vstopa v drevesa Shadow DOM.

doc.documentElement je lastnost samo za branje: vrne korenski element (<html> v dokumentu HTML; v XML je lahko drug element) ali null, če ga ni. doc.body vrne prvi neposredni otrok elementa <html>, ki je <body> ali zastareli <frameset>, oziroma null, če takega otroka ni. Obe lastnosti preberi brez oklepajev.

V nasprotju z documentElement lahko lastnosti body prirediš novo vrednost in s tem zamenjaš obstoječi element. Njegovi otroci se ne premaknejo v novi element. Prireditev vrednosti null ali objekta HTMLElement, ki ni niti <body> niti <frameset>, sproži HierarchyRequestError. Če element ne implementira vmesnika HTMLElement, kot na primer element SVG, pretvorba po pravilih Web IDL sproži TypeError, še preden se pokliče nastavitvena metoda. Prireditev veljavnega elementa <body> ali <frameset> prav tako sproži HierarchyRequestError, če dokument nima korenskega elementa.

Med razčlenjevanjem HTML telo dokumenta ali iskani element morda še ne obstaja. Če je koda odvisna od oznak strani, pri document.readyState === "loading" počakaj na DOMContentLoaded; sicer jo izvedi takoj. Pred uporabo preveri, da rezultat ni null: neposredno branje lastnosti vrednosti null sproži TypeError. Te vmesnike API določata standarda DOM in HTML, ne ECMAScript. Oznaka ECMAScript 2024 ne pove, ali so na voljo; izvajalno okolje za JavaScript ne zagotavlja nujno objekta document.

Primeri

<!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

Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v razvijalski konzoli. Ločeni dokument HTML že vsebuje `html` in `body` in ne spremeni strani, na kateri se izvaja skript. `Panel` je mogoče najti šele po vstavljanju; `panel` se ne ujema zaradi razlike med veliko in malo črko.

Povezane lekcije

  • JavaScript · Lekcija 37 · Napredna · Različica: 4

Viri