CKTIS / JavaScript
document.createElement — ustvarjanje elementa DOM
document.createElement ustvari nov element DOM z navedenim imenom. Samodejno ga ne vstavi v dokument.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
document.createElement(localName)
document.createElement(localName, options)document.createElement(localName, options) vrne nov element brez nadrejenega vozlišča. Argument localName je ime elementa, ne oznaka HTML. Vsebino nastavi z textContent, element pa vstavi posebej, na primer z appendChild.
V dokumentu HTML se ime pretvori v male črke ASCII. Neveljavno ime sproži DOMException z imenom InvalidCharacterError. Za izrecno izbiro imenskega prostora uporabi createElementNS.
V izbirnem argumentu options lastnost is določa registrirano ime elementa po meri, ki razširja vgrajeni element, naveden z localName. Če želiš ustvariti samostojen element po meri, podaj njegovo registrirano ime neposredno kot localName, ne kot options.is. Safari ne podpira elementov po meri, ki razširjajo vgrajene elemente, zato ta uporaba options.is ne deluje v vseh brskalnikih.
Primer prikazuje samo klic z enim argumentom, brez options. Zahteva dokument HTML v brskalniku; sama podpora za JavaScript ne zagotavlja, da je document na voljo.
Primeri
const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);Rezultat
div Hello true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.