CKTIS / JavaScript
document.getElementById — vyhľadanie prvku podľa ID
document.getElementById(elementId) vráti prvok so zadaným ID alebo null. Vyhľadávanie rozlišuje veľké a malé písmená a prehľadáva potomkov dokumentu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
document.getElementById(elementId)document.getElementById(elementId) je metóda DOM, nie samotného ECMAScriptu. Odovzdajte hodnotu id, napríklad "status", bez predpony #: argument nie je CSS selektor. Výsledkom je Element alebo null. Vyhľadávanie rozlišuje veľké a malé písmená; prázdny identifikátor sa nezhoduje so žiadnym prvkom.
Metóda prehľadáva potomkov dokumentu. Odpojený prvok nenájde. Pri duplicitných ID vráti prvý prvok v poradí stromu, nie nevyhnutne prvok vytvorený ako prvý. Pred použitím výsledku skontrolujte, či nie je null; vyhľadávanie vykonajte až po pridaní cieľového prvku do dokumentu.
getElementById je dostupné aj na DocumentFragment, nie však na bežných objektoch Element. Vyhľadávanie v dokumente nevstupuje do tieňových stromov. Príklad vyžaduje prostredie prehliadača s DOM; samotná verzia Node.js nepotvrdzuje dostupnosť tohto API.
Prí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ýsledok
true true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.