Metoda importNode() DOM XML

Podręcznik referencyjny Document

Definicja i użycie

Metoda importNode() kopiuje węzeł z innego dokumentu do bieżącego dokumentu w celu zastosowania.

语法:

importNode(importedNode,deep)
Parametr Opis
importedNode Węzeł do zaimportowania
deep jeśli wynosi true, kopiowane będą również wszystkie potomne węzły węzła importedNode.

Wartość zwracana

importedNode kopia (może również jej potomkowie) i jej atrybut ownerDocument ustawiony na ten dokument.

wywoła

jeśli importedNode jest węzłem Document lub węzłem DocumentType, metoda ta wywoła wyjątek NOT_SUPPORTED_ERR. Wyjątek DOMExceptionponieważ nie można zaimportować tych typów węzłów.

Opis

Parametr tego metody to węzeł zdefiniowany w innym dokumencie, wartość zwracana to kopia węzła, która jest odpowiednia do wstawienia do tego dokumentu. Jeśli deep Jeśli wartość wynosi true, kopiowane będą również wszystkie potomne węzły tego węzła. W każdym razie oryginalny węzeł i jego potomkowie nie będą modyfikowani.

Atrybut ownerDocument zwracanej kopii ustawiany jest na bieżący dokument, ale atrybut parentNode jest ustawiany na null, ponieważ jeszcze nie został wstawiony do dokumentu. Funkcje słuchaczy zdarzeń zarejestrowane na oryginalnym węźle lub drzewie nie będą kopiowane.

Podczas importowania węzła Element, tylko atrybuty wyraźnie ustawione w źródłowym dokumencie będą importowane. Podczas importowania węzła Attr, jego atrybut specified zostanie automatycznie ustawiony na true.

Zobacz

Node.cloneNode()

Podręcznik referencyjny Document