Metoda importNode() DOM XML
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.