Node.appendChild()
Die Node.appendChild()
Methode fügt einen Kind-Knoten am Ende der Liste aller Kinder des angegebenen Eltern-Knotens an (to append = anhängen).
Wenn das gegebene Kind eine Referenz zu einem existierenden Knoten im Dokument ist, wird appendChild()
es von der aktuellen Position zu der neuen Position bewegen. Es gibt also keine Notwendigkeit den Knoten erst zu entfernen, weil ein Knoten in einem Dokument nicht gleichzeitig an zwei Stellen vorkommen kann. Also, wenn der Knoten bereits einen Eltern-Knoten hat, wird der Knoten zuerst entfernt und dann erneut am Ende der Kind-Knoten-Liste angehängt.
Das Node.cloneNode()
kann genutzt werden um eine Kopie des Knotens zu machen, bevor es an einen neuen Eltern-Knoten angehängt wird. Zu beachten: Kopien die mit cloneNode
gemacht wurden, werden nicht automatisch Synchron gehalten.
Syntax
var aChild = element.appendChild(aChild);
Parameter
aChild
Der Knoten, der an den gegebenen Eltern-Knoten angehängt wird (für gewöhnlich ein Element).
Rückgabewert
Der Rückgabewert ist das angehängte Kindelement (aChild
), außer wenn aChild ein DocumentFragment
ist. In diesem Fall wird ein DocumentFragment
zurückgegeben.
Anmerkungen
Eine Verkettung kann anders ablaufen als erwartet, da appendChild() das Kindelement zurück gibt.
var aBlock = doc.createElement('block').appendChild(doc.createElement('b'));
Setzt nur aBlock
auf <b></b>
, was möglicherweise nicht das gewünschte ist.
Beispiele
// Erstellen Sie ein neues Absatz-Element und fügen Sie es an das Ende des Dokument-Körpers (body)
var p = document.createElement("p");
document.body.appendChild(p);
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
DOM Die Definition von 'Node.appendChild()' in dieser Spezifikation. |
Lebender Standard | No change from Document Object Model (DOM) Level 3 Core Specification. |
Document Object Model (DOM) Level 3 Core Specification Die Definition von 'Node.appendChild()' in dieser Spezifikation. |
Veraltet | No change from Document Object Model (DOM) Level 2 Core Specification. |
Document Object Model (DOM) Level 2 Core Specification Die Definition von 'Node.appendChild()' in dieser Spezifikation. |
Veraltet | No change from Document Object Model (DOM) Level 1 Specification. |
Document Object Model (DOM) Level 1 Specification Die Definition von 'Node.appendChild()' in dieser Spezifikation. |
Veraltet | Initial definition. |
Browserkompatibilität
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basis Unterstützung | (Ja) | (Ja) | 1.0 (1.7 oder früher) | (Ja) | (Ja) | (Ja) |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basis Unterstützung | (Ja) | (Ja) | 1.0 (1.0) | (Ja) | (Ja) | (Ja) |