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

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.

Zdroje