Document.createElement()

Springen zu:
  1. Syntax
  2. Beispiel
  3. Notizen
  4. Spezifikationen

Diese Übersetzung ist in Arbeit.

 

In einem HTML Dokument erstellt die Document.createElement() Methode ein spezifiziertes HTML Element oder ein HTMLUnknownElement wenn der gegebene Elementname ein unbekannter ist.

Notiz: In einem XUL Dokument erstellt diese Methode das spezifizierte XUL Element. In anderen Dokumenten erstellt sie ein Element mit einer null Namensraum URl.

Syntax

var element = document.createElement(tagName);

Parameter

  • element ist das erstellte Element Objekt.
  • tagName ist ein String der den Typ des zu erstellenden Elements spezifiziert. Der/Die/Das nodeName des erstellten Elements ist mit dem Wert von tagName initialisiert. Benutze keine qualifizierten Namen (wie "html:a") mit dieser Methode.

Rückgabewert

Das neue Element.

Beispiel

Dies erstellt ein neues <div> und fügt es vor dem Element mit der ID "div1" ein.

HTML

<!DOCTYPE html>
<html>
<head>
  <title>||Arbeiten mit Elementen||</title>
</head>
<body>
  <div id="div1">Der obere Text wurde dynamisch erstellt.</div>
</body>
</html>

JavaScript

document.body.onload = addElement;

function addElement () { 
  // erstelle ein neues div Element
  // und gib ihm etwas Inhalt
  var newDiv = document.createElement("div"); 
  var newContent = document.createTextNode("Hi there and greetings!"); 
  newDiv.appendChild(newContent); // füge den Textknoten zum neu erstellten div hinzu.

  // füge das neu erstellte Element und seinen Inhalt ins DOM ein
  var currentDiv = document.getElementById("div1"); 
  document.body.insertBefore(newDiv, currentDiv); 
}

Notizen

  • Beim Aufruf auf ein als Dokument-Objekt gekennzeichnetes HTML-Dokument schreibt createElement() seine Argumente in Kleinbuchstaben, bevor es das diese erstellt.
  • Um ein Element mit qualifizierem Namen und namespace URl zu erstellen nutze document.createElementNS() stattessen .
  • Vor Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), konntest du abgewinkelte Klammern (< und >)  um tagName im Quirks-Modus setzen; seit Gecko 2.0 verhält sich die Funktion im Quirks-Modus und im Standard-Modus gleich.
  • Seit Gecko 19.0 (Firefox 19.0 / Thunderbird 19.0 / SeaMonkey 2.16) createElement(null) hat das gleiche bewirkt wie createElement("null").  Bemerke, dass Opera funktioniert mit null ebenfalls, während Chrome und Internet Explorer beide Fehler ausgeben würden.
  • Seit Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19) benutzt createElement() nicht mehr die  HTMLSpanElement Schnittstelle, wenn das Argument "bgsounds", "multicol", oder "image" ist. Stattdessen wird HTMLUnknownElement für"bgsound" und "multicol" verwendet, und HTMLElement HTMLElement wird für "image" verwendet.
  • Die Gecko Implementierung von createElement ist nicht konform mit der DOM Spezifikation für  XUL und XHTML Dokumente: localName und namespaceURI werden beim erstellten Element nicht auf null gesetzt.. Siehe auch  Bug 280692 für weitere Details.

Spezifikationen

Spezifikation Status Kommentar
DOM
Die Definition von 'Document.createElement' in dieser Spezifikation.		 Lebender Standard  

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
Mitwirkende an dieser Seite: jakobpack, StevenS77, Johann, fscholz, jsx, MikeSierra
Zuletzt aktualisiert von: jakobpack,