XML DOM importNode() Methode

Dokument-Objekt Referenzhandbuch

Definition und Verwendung

Die Methode importNode() kopiert einen Knoten von einem anderen Dokument in das aktuelle Dokument, um ihn anzuwenden.

语法:

importNode(importedNode,tief)
Parameter Beschreibung
importedNode Knoten, die importiert werden sollen.
tief wenn true, werden alle Nachkommenknoten des importedNode-Knotens ebenfalls rekursiv kopiert.

Rückgabewert

importedNode und möglicherweise seiner Nachkommenknoten) eine Kopie, deren ownerDocument-Attribut auf dieses Dokument gesetzt wird.

wird ausgelöst

wenn importedNode ist ein Document-Knoten oder ein DocumentType-Knoten, und eine NOT_SUPPORTED_ERR mit dem Code wird ausgelöst. DOMException Ausnahmekann nicht importiert werden, weil diese Knotenarten nicht importiert werden können.

Beschreibung

Der Parameter dieses Verfahrens ist ein Knoten, der in einem anderen Dokument definiert ist, und das Rückgabewert ist eine Kopie des Knotens, die in das Dokument eingefügt werden kann. Wenn tief Wenn der Wert true ist, werden alle Nachkommenknoten des Knotens ebenfalls kopiert. In jedem Fall werden der ursprüngliche Knoten und seine Nachkommenknoten nicht geändert.

Das ownerDocument-Attribut des zurückgegebenen Kopies wird auf das aktuelle Dokument gesetzt, aber das parentNode-Attribut ist null, da es noch nicht in das Dokument eingefügt wurde. Event-Listener-Funktionen, die im ursprünglichen Knoten oder im Baum registriert sind, werden nicht kopiert.

Bei der Einführung von Element-Knoten werden nur die Attribute importiert, die im Quelldokument explizit eingestellt wurden. Beim Importieren von Attr-Knoten wird automatisch die specified-Eigenschaft auf true gesetzt.

Siehe auch

Node.cloneNode()

Dokument-Objekt Referenzhandbuch