Метод importNode() DOM HTML

定义和用法

Определение и использование importNode()

Метод импортирует узел из другого документа. Второй параметр устанавливается true

при этом также будут импортированы подузлы.

Подсказка

Импортированный узел не удаляется из исходного документа.

Импортированный узел является дубликатом исходного узла.

См. также:

Метод document.adoptNode()

Метод element.cloneNode()

Пример

Импортируем первый <h1> элемент из iframe (другого документа):
const frame = document.getElementsById("myFrame");
const h1 = frame.contentWindow.document.getElementsByTagName("H1")[0];

const node = document.importNode(h1, true);

Попробуйте сами

СинтаксисЭтот методdocument.importNode( Параметр - это узел, определенный в другом документе, возвращаемое значение - это дубликат узла, подходящий для вставки в этот документ. Если,

)

) Тип
Этот метод Параметр
Параметр - это узел, определенный в другом документе, возвращаемое значение - это дубликат узла, подходящий для вставки в этот документ. Если

Обязателен. Узел из другого документа.

  • Обязателен.
  • false: импортируется только узел сам.

true: также импортируются подузлы (потомки).

Возвратное значение Тип
Описание узел

импортированный узел.

выбрасывает Этот метод Если является узлом Document или узлом DocumentType, этот метод выбрасывает код NOT_SUPPORTED_ERR

DOMException исключение, так как эти типы узлов импортировать невозможно.

Технические детали Этот метод узел Параметр - это узел, определенный в другом документе, возвращаемое значение - это дубликат узла, подходящий для вставки в этот документ. Если глубокий

При импорте узла Element только те атрибуты будут импортированы, которые явно установлены в исходном документе. При импорте узла Attr автоматически устанавливается значение его атрибута specified в true. Если значение true, то также будут скопированы все потомки узла. В любом случае, исходный узел и его потомки не будут изменены. Атрибут ownerDocument возвращаемого дубликата устанавливается в текущий документ, но атрибут parentNode устанавливается в null, так как он еще не вставлен в документ. Функции监听器 событий, зарегистрированные в исходном узле дерева, не будут скопированы.

Поддержка браузерами

document.importNode() Это функция DOM Level 2 (2001).

Все браузеры поддерживают его:

Chrome IE Edge Firefox Сafari Опера
Chrome IE Edge Firefox Сafari Опера
Поддержка 9-11 Поддержка Поддержка Поддержка Поддержка