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

CKTIS / JavaScript

document.getElementById — vyhledání prvku podle ID

document.getElementById(elementId) vrací prvek se zadaným ID, nebo null. Vyhledávání rozlišuje velká a malá písmena a prohledává potomky dokumentu.

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(elementId)

document.getElementById(elementId) je metoda DOM, nikoli samotného ECMAScriptu. Předejte hodnotu id, například "status", bez předpony #: argument není CSS selektor. Výsledkem je Element nebo null. Vyhledávání rozlišuje velká a malá písmena; prázdný identifikátor ničemu neodpovídá.

Metoda prohledává potomky dokumentu. Odpojený prvek nenajde. Při duplicitních ID vrací první prvek v pořadí stromu, což nemusí být prvek vytvořený jako první. Před použitím výsledku ověřte, že není null; vyhledávání proveďte až poté, co cílový prvek přidáte do dokumentu.

getElementById je dostupné také na DocumentFragment, nikoli však na běžných objektech Element. Vyhledávání v dokumentu nevstupuje do stínových stromů. Příklad vyžaduje prostředí prohlížeče s DOM; samotná verze Node.js nedokládá dostupnost tohoto API.

Příklady

{
  const document = globalThis.document.implementation.createHTMLDocument("");
  const item = document.createElement("div");
  item.id = "status";

  console.log(document.getElementById("status") === null);
  document.body.appendChild(item);
  console.log(document.getElementById("status") === item);
  console.log(document.getElementById("Status") === null);
  item.remove();
  console.log(document.getElementById("status") === null);
}

Výsledek

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