Dokument: importNode()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die importNode()-Methode des Document-Objekts erstellt eine Kopie eines Node- oder DocumentFragment-Elements aus einem anderen Dokument, um es später in das aktuelle Dokument einzufügen.

Der importierte Knoten ist noch nicht im Dokumentenbaum enthalten. Um ihn einzufügen, müssen Sie eine Einfügemethode wie appendChild() oder insertBefore() mit einem Knoten aufrufen, der bereits im Dokumentenbaum vorhanden ist.

Im Gegensatz zu document.adoptNode() wird der originale Knoten nicht aus seinem ursprünglichen Dokument entfernt. Der importierte Knoten ist eine Kopie des Originals.

Syntax

js
importNode(externalNode)
importNode(externalNode, deep)

Parameter

externalNode

Der externe Node oder DocumentFragment, der in das aktuelle Dokument importiert werden soll.

deep Optional

Ein boolescher Wert, dessen Standardwert false ist, der steuert, ob der gesamte DOM-Unterbaum des externalNode in den Import einbezogen wird.

  • Wenn deep auf true gesetzt ist, dann werden externalNode und alle seine Nachkommen kopiert.
  • Wenn deep auf false gesetzt ist, dann wird nur externalNode importiert — der neue Knoten hat keine Kinder.

Rückgabewert

Der kopierte importedNode im Kontext des importierenden Dokuments.

Hinweis: Der importedNode hat null als Node.parentNode, da er noch nicht in den Dokumentenbaum eingefügt wurde!

Beispiele

js
const iframe = document.querySelector("iframe");
const oldNode = iframe.contentWindow.document.getElementById("myNode");
const newNode = document.importNode(oldNode, true);
document.getElementById("container").appendChild(newNode);

Anmerkungen

Bevor sie in das aktuelle Dokument eingefügt werden können, sollten Knoten aus externen Dokumenten entweder:

Hinweis: Obwohl Firefox diese Regel derzeit nicht durchsetzt, empfehlen wir Ihnen, diese Regel zu befolgen, um die zukünftige Kompatibilität zu verbessern.

Weitere Informationen zu den Fragen im Zusammenhang mit Node.ownerDocument finden Sie in den W3C DOM-FAQ.

Spezifikationen

Specification
DOM
# ref-for-dom-document-importnode①

Browser-Kompatibilität

Siehe auch