XML DOM importNode() 方法
定義和用法
importNode() 方法把一個節(jié)點(diǎn)從另一個文檔復(fù)制到該文檔以便應(yīng)用。
語法:
importNode(importedNode,deep)
參數(shù) | 描述 |
---|---|
importedNode | 要導(dǎo)入的節(jié)點(diǎn)。 |
deep | 如果為 true,還要遞歸復(fù)制 importedNode 節(jié)點(diǎn)的所有子孫節(jié)點(diǎn)。 |
返回值
importedNode (可能還有它的子孫節(jié)點(diǎn))的副本,它的 ownerDocument 屬性設(shè)置到該文檔。
拋出
如果 importedNode 是 Document 節(jié)點(diǎn)或 DocumentType 節(jié)點(diǎn),該方法將拋出代碼為 NOT_SUPPORTED_ERR 的 DOMException 異常,因?yàn)椴荒軐?dǎo)入這些類型的節(jié)點(diǎn)。
說明
該方法的參數(shù)是另一個文檔中定義的節(jié)點(diǎn),返回值是適合插入該文檔的節(jié)點(diǎn)的副本。如果 deep 值為 true,那么還要復(fù)制該節(jié)點(diǎn)的所有子孫節(jié)點(diǎn)。無論如何,原始節(jié)點(diǎn)和它的子孫節(jié)點(diǎn)都不會被修改。
返回的副本的 ownerDocument 屬性被設(shè)置為當(dāng)前文檔,但是 parentNode 屬性為 null,因?yàn)樗沒有插入文檔。在原始節(jié)點(diǎn)或樹中注冊的事件監(jiān)聽器函數(shù)不會被復(fù)制。
當(dāng)導(dǎo)入 Element 節(jié)點(diǎn)時,只有在源文檔中明確設(shè)置的屬性才會被導(dǎo)入。當(dāng)導(dǎo)入 Attr 節(jié)點(diǎn)時,將自動把它的 specified 屬性設(shè)置為 true。