CKTIS / JavaScript
Document — dostop do dokumenta strani
Document predstavlja dokument DOM. Z objektom document lahko poiščete elemente, preberete koren dokumenta in uporabljate lastnosti strani za naslov, fokus in vidnost. Gre za vmesnik spletne platforme, ne za del samega ECMAScripta.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
document.getElementById(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)Document predstavlja dokument DOM; v skriptu strani se document nanaša na trenutni dokument. Ni niti window niti korenski element. Gre za vmesnik spletne platforme: sama razpoložljivost JavaScripta, tudi v Node 24, še ne dokazuje podpore zanj.
Document.getElementById(id) vrne prvi ujemajoči se element po vrstnem redu drevesa ali null. Podaj identifikator brez # in pred uporabo preveri rezultat. Document.documentElement označuje korenski element ali ima vrednost null. Na tipični strani HTML je to element html. Document.body zagotavlja element body ali frameset, vendar je lahko null, na primer preden ga ustvari razčlenjevalnik. Document.title omogoča branje ali spreminjanje naslova dokumenta.
Document.activeElement označuje element, povezan s fokusom; ni nujno besedilno polje. Če je fokus znotraj vdelanega dokumenta ali drevesa sence, lahko namesto najglobljega elementa označuje element, ki dokument vdeluje, oziroma gostitelja. Document.hidden je logična vrednost, ki pove, ali je dokument skrit, ne pa, ali nima fokusa. Document.visibilitychange označuje dogodek visibilitychange, ne metode: obravnavaj ga z document.addEventListener("visibilitychange", handler) in v obravnavalniku preberi document.hidden.
Primer ustvari ločen dokument HTML, zato ne spremeni odprte strani in ustvari predvidljive vrednosti. Ne preizkuša fokusa ali vidnosti, saj sta odvisna od okolja. Pokritost virov je omejena: navedeni DOM Standard določa jedro vmesnika Document, ne pa vseh naštetih razširitev HTML glede naslova, telesa, fokusa in vidnosti. Najnižje različice brskalnikov tukaj niso bile določene.
Primeri
const demo = document.implementation.createHTMLDocument("Document demo");
const item = demo.createElement("p");
item.id = "message";
item.textContent = "Hello, DOM";
demo.body.appendChild(item);
console.log(demo.documentElement.localName);
console.log(demo.body.localName);
console.log(demo.title);
console.log(demo.getElementById("message").textContent);
console.log(demo.getElementById("missing") === null);Rezultat
html body Document demo Hello, DOM true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.