.importNode()

https://developer.mozilla.org/en-US/docs/Web/API/document.importNode

外部ドキュメントから、現在のドキュメント内へ挿入可能なノードのコピーを作成します。

文法

var node = document.importNode(externalNode, deep);

引数	説明
externalNode	インポートされる別のドキュメンとからのノードを指定します。
deep	インポートされるノードの子孫もインポートされる必要があるか否かを真偽値で指定します。
戻り値
node	ドキュメントにインポートされた新しいノードです。インポートされた(取り込んだ)だけで、まだドキュメントツリーへ挿入されていないため、この新しいノードのparentNodeはnullです。

注意: DOM4仕様(Gecko 13.0 (Firefox 13 / Thunderbird 13 / SeaMonkey 2.10)に実装されている)では、 deepは任意の引数です。もし省略すると、メソッドはdeepをtrueとし、深い複製をデフォルトの挙動とします。浅い複製を作成するには、deepをfalseに設定しなければいけません。

この仕様は最新の仕様で変更され、もし省略されるとdeepはfalseであるとして振る舞います。まだ任意の引数のままですが、後方・前方互換の両方のために、deep引数は常に提供すべきです。 Gecko 28.0 (Firefox 28 / Thunderbird 28 / SeaMonkey 2.25)では、この引数が省略されると開発者に対して、コンソールで警告が表示されます。 Gecko 29.0 (Firefox 29 / Thunderbird 29 / SeaMonkey 2.26))以降では、浅い複製がデフォルトになりました。

例

var iframe = document.getElementsByTagName("iframe")[0];
var oldNode = iframe.contentDocument.getElementById("myNode");
var newNode = document.importNode(oldNode, true);
document.getElementById("container").appendChild(newNode);

注意事項

元のノードは元のドキュメントから削除されません。インポートされるノードは、その元のノードの複製です。

外部ドキュメントからのノードは、現在のドキュメントへ挿入されることになる前に document.importNode()を使用して複製される(または、document.adoptNode()を使用して取り込む)べきです。 Node.ownerDocumentの問題についての詳細を知りたければ、 W3C DOM FAQを参照してください。

Firefoxは現在このルールを強制しません。 (Firefox 3の開発中はこれを行っていましたが、このルールを強制するとあまりにも多くのサイトが壊れてしまった) Webデベロッパーに対しては、この改善された機能の互換性のルールに従うコードに修正することが推奨されています。

ブラウザ互換性

デスクトップ
機能	Chrome	Firefox (Gecko)	IE	Opera	Safari
基本	◯	1.0 (1.7 or earlier)	9.0	9.0	◯
DOM 4 version (deep引数)	◯	10 (10)	×	×	Nightly build

モバイル
機能	Android	Firefox Mobile	IE Mobile	Opera Mobile	Safari Mobile
基本	?	1.0 (1)	?	?	?
DOM 4 version (deep引数)	?		10.0 (10)	?	?	?

.importNode()

文法

例

注意事項

ブラウザ互換性

仕様

関連項目