Metoda importNode() DOM HTML

definicja i użycie

importNode() metoda importuje węzeł z innego dokumentu.

drugi parametr ustawiony jest na true gdy jest ustawiona na

Wskazówka

Zaimportowany węzeł nie jest usuwany z oryginalnego dokumentu.

Zaimportowany węzeł jest kopią oryginalnego węzła.

Zobacz również:

metoda document.adoptNode()

metoda element.cloneNode()

Przykład

Importowanie pierwszego elementu <h1> z iframe (innego dokumentu):

const frame = document.getElementsById("myFrame");
const h1 = frame.contentWindow.document.getElementsByTagName("H1")[0];
const node = document.importNode(h1, true);

Spróbuj sam!

schemat

document.importNode(node, deep)

parametr

parametr opis
node wymagane. Węzeł z innego dokumentu.
deep

wymagane.

  • false: importowany jest tylko sam węzeł.
  • true: importowane są również potomki (potomkowie).

zwracana wartość

typ opis
węzeł zaimportowany węzeł.

wywoła

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

szczegółowe informacje techniczne

metoda ta node Parametr to węzeł zdefiniowany w innym dokumencie, zwracana wartość to kopia węzła, która jest odpowiednia do wstawienia do tego dokumentu. Jeśli deep Jeśli wartość wynosi true, należy skopiować wszystkie potomki tego węzła. W każdym razie oryginalny węzeł i jego potomkowie nie będą modyfikowane. Atrybut ownerDocument zwróconej kopii ustawiany jest na bieżący dokument, ale atrybut parentNode ustawiany jest na null, ponieważ jeszcze nie został wstawiony do dokumentu. Funkcje słuchaczy zdarzeń zarejestrowane w oryginalnym drzewie węzłów nie będą kopiowane.

Kiedy importuje się węzeł Element, tylko te atrybuty, które są wyraźnie ustawione w dokumencie źródłowym, są importowane. Kiedy importuje się węzeł Attr, automatycznie ustawia jego atrybut specified na true.

Obsługa przeglądarki

document.importNode() To jest cecha DOM Level 2 (2001).

Wszystkie przeglądarki obsługują to:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Wsparcie 9-11 Wsparcie Wsparcie Wsparcie Wsparcie