CKTIS / JavaScript
document.createElement — vytvoření prvku DOM
document.createElement vytvoří nový prvek DOM se zadaným názvem. Automaticky ho nevloží do 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.createElement(localName)
document.createElement(localName, options)document.createElement(localName, options) vrátí nový prvek bez nadřazeného uzlu. Argument localName je název prvku, nikoli kód HTML. Obsah nastavte pomocí textContent a prvek vložte samostatně, například pomocí appendChild.
V dokumentu HTML se název převede na malá písmena ASCII. Neplatný název vyvolá DOMException s názvem InvalidCharacterError. K výslovnému výběru jmenného prostoru použijte createElementNS.
Ve volitelném argumentu options určuje vlastnost is registrovaný název vlastního prvku, který rozšiřuje vestavěný prvek označený argumentem localName. Chcete-li vytvořit autonomní vlastní prvek, předejte jeho registrovaný název přímo jako localName, nikoli jako options.is. Safari nepodporuje vlastní prvky rozšiřující vestavěné prvky, takže toto použití options.is nefunguje ve všech prohlížečích.
Příklad ukazuje pouze volání s jedním argumentem, bez options. Vyžaduje dokument HTML v prohlížeči; samotná podpora JavaScriptu nezaručuje, že bude document k dispozici.
Příklady
const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);Výsledek
div Hello 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.