CKTIS / JavaScript
Iskanje elementa po ID-ju in preverjanje stanja dokumenta
`getElementById()` preveri, ali je element trenutno v drevesu dokumenta. `readyState` pove, v kateri fazi je nalaganje, ne pa, ali je določen element prisoten.
Različica: Current web platform; runtime support varies
Sintaksa
document.getElementById(id); // Element | null
document.readyState; // "loading" | "interactive" | "complete"document.getElementById(id) išče po trenutnem drevesu tega dokumenta. Podaj natančno vrednost id, upoštevaj velike in male črke ter ne dodajaj predpone # iz izbirnikov CSS. Metoda vrne Element ali null. Če se ID ponovi, vrne prvi zadetek po vrstnem redu v drevesu, vendar morajo biti ID-ji v dokumentu HTML enolični. Preveri rezultat: branje lastnosti vrednosti null sproži TypeError.
document.readyState je lastnost samo za branje, ne metoda. Pri običajnem nalaganju strani "loading" pomeni, da razčlenjevanje dokumenta še poteka, "interactive" pa, da je končano. Pri "complete" so naloženi viri, ki zadržujejo dogodek load na objektu window, tik preden se ta dogodek sproži. Sprememba stanja sproži readystatechange na dokumentu. DOMContentLoaded se sproži po prehodu v "interactive", po izvedbi klasičnih skriptov z defer in po tem, ko brskalnik začne vrednotiti modulske skripte brez async, predvidene za izvajanje po razčlenjevanju. Dogodek ne zagotavlja, da se je koda za await na najvišji ravni modula že izvedla. Ne čaka neposredno na slike.
Če za inicializacijo potrebuješ le DOM po razčlenjevanju, pri document.readyState === "loading" na dokumentu registriraj poslušalca za DOMContentLoaded z možnostjo { once: true }; sicer inicializacijo zaženi takoj. "interactive" ne zagotavlja, da se je DOMContentLoaded že sprožil. Tudi pri "complete" lahko iskanje vrne null, na primer če aplikacija element vstavi pozneje. Standard DOM določa getElementById(), standard HTML pa določa readyState. Oboje spada med spletne API-je, ne v ECMAScript; okolje brez brskalnikovega DOM-a ju morda ne ponuja.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document readiness and ID lookup</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument();
const item = doc.createElement("p");
item.id = "status";
console.log(doc.readyState);
console.log(doc.getElementById("status") === null);
doc.body.append(item);
console.log(doc.getElementById("status") === item);
console.log(doc.getElementById("Status") === null);
</script>
</body>
</html>Rezultat
complete true true true
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli. Novi dokument je že v stanju `complete`, vendar iskanje najde `status` šele po vstavitvi elementa. `Status` se še vedno ne ujema.
Povezane lekcije
- JavaScript · Lekcija 39 · Srednja · Različica: 3