CKTIS / JavaScript
document.createElement — ein DOM-Element erstellen
document.createElement erstellt ein neues DOM-Element mit dem angegebenen Namen. Es fügt es nicht automatisch in das Dokument ein.
Version: 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.createElement(localName)
document.createElement(localName, options)document.createElement(localName, options) gibt ein neues Element ohne übergeordneten Knoten zurück. Das Argument localName ist ein Elementname, kein HTML-Markup. Lege den Inhalt mit textContent fest und füge das Element separat ein, zum Beispiel mit appendChild.
In einem HTML-Dokument wird der Name in ASCII-Kleinbuchstaben umgewandelt. Ein ungültiger Name löst eine DOMException namens InvalidCharacterError aus. Verwende createElementNS, um ausdrücklich einen Namensraum auszuwählen.
Im optionalen Argument options gibt is den registrierten Namen eines benutzerdefinierten Elements an, das das durch localName bezeichnete eingebaute Element erweitert. Um ein autonomes benutzerdefiniertes Element zu erstellen, übergib seinen registrierten Namen direkt als localName, nicht als options.is. Safari unterstützt keine benutzerdefinierten Erweiterungen eingebauter Elemente. Diese Verwendung von options.is funktioniert daher nicht in allen Browsern.
Das Beispiel zeigt nur den Aufruf mit einem Argument, ohne options. Es erfordert ein HTML-Dokument in einem Browser; die Unterstützung von JavaScript allein garantiert nicht, dass document verfügbar ist.
Beispiele
const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);Ergebnis
div Hello true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.