Dokument: Methode adoptNode()
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.
Document.adoptNode() überträgt einen node von einem anderen document in das Dokument der Methode.
Der übernommene Knoten und sein Unterbaum werden aus ihrem ursprünglichen Dokument (falls vorhanden) entfernt, und ihr ownerDocument wird auf das aktuelle Dokument geändert.
Der Knoten kann dann in das aktuelle Dokument eingefügt werden.
Syntax
adoptNode(externalNode)
Parameter
externalNode-
Der Knoten aus einem anderen Dokument, der übernommen werden soll.
Rückgabewert
Der kopierte importedNode im Gültigkeitsbereich des importierenden Dokuments.
Nach dem Aufrufen dieser Methode sind importedNode und
externalNode dasselbe Objekt.
Hinweis:>importedNode's
Node.parentNode ist null, da er noch nicht in den Dokumentbaum
eingefügt wurde!
Beispiele
const iframe = document.querySelector("iframe");
const iframeImages = iframe.contentDocument.querySelectorAll("img");
const newParent = document.getElementById("images");
iframeImages.forEach((imgEl) => {
newParent.appendChild(document.adoptNode(imgEl));
});
Hinweise
Bevor Knoten aus externen Dokumenten in das aktuelle Dokument eingefügt werden können, sollten sie entweder:
- durch
document.importNode()geklont werden; oder - durch
document.adoptNode()übernommen werden.
Für weitere Informationen zu den Problemen mit Node.ownerDocument siehe die W3C DOM FAQ.
Spezifikationen
| Specification |
|---|
| DOM # ref-for-dom-document-adoptnode① |