Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Document — přístup k dokumentu stránky

Document představuje dokument DOM. Objekt document umožňuje vyhledávat prvky, číst kořen dokumentu a používat vlastnosti stránky týkající se názvu, fokusu a viditelnosti. Jde o rozhraní webové platformy, nikoli o součást samotného ECMAScriptu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

document.getElementById(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)

Document představuje dokument DOM; ve skriptu stránky odkazuje document na aktuální dokument. Není to ani window, ani kořenový prvek. Jde o rozhraní webové platformy: samotná dostupnost JavaScriptu, včetně Node 24, nedokazuje, že je toto rozhraní podporováno.

Document.getElementById(id) vrací první odpovídající prvek v pořadí stromu, nebo null. Předej identifikátor bez # a před použitím výsledek zkontroluj. Document.documentElement označuje kořenový prvek, případně má hodnotu null. Na typické stránce HTML jde o prvek html. Document.body zpřístupňuje prvek body nebo frameset, ale může mít hodnotu null, například než jej vytvoří parser. Document.title umožňuje přečíst nebo změnit název dokumentu.

Document.activeElement označuje prvek spojený s fokusem; nemusí jít o textové pole. Pokud je fokus uvnitř vloženého dokumentu nebo stromu shadow DOM, může místo nejhlubšího prvku označovat vložený prvek, respektive hostitele. Document.hidden je booleovská hodnota popisující, zda je dokument skrytý, nikoli zda nemá fokus. Document.visibilitychange označuje událost visibilitychange, nikoli metodu: obsluž ji pomocí document.addEventListener("visibilitychange", handler) a v obslužné rutině čti document.hidden.

Příklad vytvoří samostatný dokument HTML, takže nezmění otevřenou stránku a poskytne předvídatelné hodnoty. Netestuje fokus ani viditelnost, protože závisí na prostředí. Pokrytí zdroji je omezené: dodaný DOM Standard definuje jádro Document, nikoli však všechna uvedená rozšíření HTML týkající se názvu, těla, fokusu a viditelnosti. Minimální verze prohlížečů zde nebyly stanoveny.

Příklady

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);

Výsledek

html
body
Document demo
Hello, DOM
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje