XML DOM importNode() メソッド

Document オブジェクトリファレンスマニュアル

定義と用法

importNode() メソッドは、別のドキュメントからノードをコピーして、そのドキュメントに適用するために使用されます。

语法:

importNode(importedNode,deep)
パラメータ 説明
importedNode インポートするノード
deep もし true であれば、importedNode ノードのすべての子孫ノードも再帰的にコピーされます。

返値

importedNode (およびその子孫ノードがあれば)のコピーを返し、その ownerDocument 属性をこのドキュメントに設定します。

を投げます。

もし importedNode Document ノードまたは DocumentType ノードであれば、NOT_SUPPORTED_ERR コードの DOMException 异常、これらのタイプのノードをインポートすることはできません。

説明

このメソッドの引数は別のドキュメントで定義されたノードであり、そのドキュメントに適したノードのコピーを返します。もし deep 値が true であれば、そのノードのすべての子孫ノードもコピーされます。いずれにせよ、元のノードとその子孫ノードは変更されません。

返されるコピーの ownerDocument 属性は現在のドキュメントに設定され、parentNode 属性は null です。なぜなら、まだドキュメントに挿入されていないからです。元のノードまたはツリーに登録されたイベントリスナー関数はコピーされません。

Element ノードをインポートする場合、元のドキュメントで明示的に設定された属性のみがインポートされます。Attr ノードをインポートする場合、自動的にその specified 属性が true に設定されます。

参照

Node.cloneNode()

Document オブジェクトリファレンスマニュアル