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

CKTIS / JavaScript

Dokument DOM: iskanje po ID-ju, korenski element in naslov

Poišči element po točnem ID-ju, pridobi korenski element ter preberi ali spremeni naslov dokumenta. Loči manjkajoče vozlišče od praznega niza.

Različica: Current web platform; runtime support varies

Sintaksa

document.getElementById(id)
document.documentElement
document.title
document.title = value

document.getElementById(id) v drevesu tega dokumenta išče element z natančno ujemajočim se id. Pri tem razlikuje med velikimi in malimi črkami. Podaj ID brez dodanega #: argument ni izbirnik CSS. Metoda vrne Element ali null; preveri rezultat, preden dostopaš do lastnosti elementa. ID-ji morajo biti znotraj drevesa enolični. Če se ID ponovi, metoda vrne prvo ujemanje po vrstnem redu v drevesu.

Iskanje upošteva stanje drevesa v trenutku klica. Ne najde elementov, ki še niso vstavljeni v dokument, niti elementov v ločenem senčnem drevesu. document.documentElement je lastnost samo za branje: vrne korenski element, v dokumentu HTML praviloma html, ali null, če korenskega elementa ni. To ni document.body.

document.title je nizovna lastnost za branje in pisanje. Ni vozlišče title, atribut title elementa ali vidni naslov na strani. Pri branju v običajnem dokumentu HTML se beli znaki ASCII na začetku in koncu odstranijo, vsako zaporedje v notranjosti pa se nadomesti z enim presledkom. Če ni elementa title, branje vrne "". Prireditev zamenja vsebino naslova z besedilom, ne z oznakami HTML. Če title manjka, ga ustvari v head, če ta obstaja; sicer se ne zgodi nič. Če je koren svg v imenskem prostoru SVG, prireditev posodobi ali ustvari njegov neposredni podrejeni element title v imenskem prostoru SVG, iz katerega se bere naslov.

Te API-je spletne platforme določata standarda DOM in HTML. Za njihovo uporabo ECMAScript 2024 ni potreben. Pri dokumentu, prikazanem v zavihku brskalnika, je naslov navadno prikazan na zavihku. Okolju brez DOM-a ni treba zagotavljati objekta document.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOM document example</title>
</head>
<body>
  <script>
    {
      const doc = document.implementation.createHTMLDocument("Draft");
      const item = doc.createElement("p");
      item.id = "status";

      console.log(doc.title);
      console.log(doc.getElementById("status") === null);
      doc.body.append(item);
      console.log(doc.getElementById("status") === item);
      console.log(doc.getElementById("Status") === null);
      console.log(doc.documentElement.localName);

      doc.title = "  Ready   to publish  ";
      console.log(doc.title);
    }
  </script>
</body>
</html>

Rezultat

Draft
true
true
true
html
Ready to publish

Shrani celoten primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli za razvijalce. Ustvari ločen dokument HTML, zato ne spremeni trenutne strani ali naslova zavihka. Tri vrednosti `true` po vrsti pokažejo, da pred vstavljanjem ni ujemanja, da se po vstavljanju vrne isti objekt in da iskanje razlikuje med velikimi in malimi črkami.

Povezane lekcije

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

Viri