Document: phương thức importNode()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Phương thức importNode() của giao diện Document tạo một bản sao của một Node hoặc DocumentFragment từ tài liệu khác, để chèn vào tài liệu hiện tại sau đó.

Nút được nhập chưa được bao gồm trong cây tài liệu. Để bao gồm nó, bạn cần gọi một phương thức chèn như appendChild() hoặc insertBefore() với một nút đang có trong cây tài liệu.

Không giống như document.adoptNode(), nút gốc không bị xóa khỏi tài liệu gốc của nó. Nút được nhập là một bản sao của bản gốc.

Phương thức Node.cloneNode() cũng tạo một bản sao của một nút. Sự khác biệt là importNode() sao chép nút trong ngữ cảnh của tài liệu gọi, trong khi cloneNode() sử dụng tài liệu của nút được sao chép. Ngữ cảnh tài liệu xác định CustomElementRegistry để xây dựng bất kỳ phần tử tùy chỉnh nào. Vì lý do này, để sao chép các nút được sử dụng trong tài liệu khác, hãy sử dụng importNode() trên tài liệu đích. HTMLTemplateElement.content được sở hữu bởi một tài liệu riêng biệt, vì vậy nó cũng nên được sao chép bằng document.importNode() để các phần tử hậu duệ tùy chỉnh được xây dựng bằng cách sử dụng các định nghĩa trong tài liệu hiện tại. Xem các ví dụ trên trang Node.cloneNode() để biết thêm chi tiết.

Cú pháp

importNode(externalNode)
importNode(externalNode, deep)

Tham số

externalNode

Node hoặc DocumentFragment bên ngoài cần nhập vào tài liệu hiện tại.

deep Optional

Một cờ boolean, có giá trị mặc định là false, kiểm soát xem có bao gồm toàn bộ cây con DOM của externalNode trong quá trình nhập hay không.

Nếu deep được đặt thành true, thì externalNode và tất cả hậu duệ của nó được sao chép.
Nếu deep được đặt thành false, thì chỉ externalNode được nhập — nút mới không có phần tử con.

const iframe = document.querySelector("iframe");
const oldNode = iframe.contentWindow.document.getElementById("myNode");
const newNode = document.importNode(oldNode, true);
document.getElementById("container").appendChild(newNode);

Ghi chú

Trước khi có thể chèn vào tài liệu hiện tại, các nút từ tài liệu bên ngoài nên:

được sao chép bằng document.importNode(); hoặc
được nhận nuôi bằng document.adoptNode().

Note: Mặc dù Firefox hiện không thực thi quy tắc này, chúng tôi khuyến khích bạn tuân theo quy tắc này để cải thiện khả năng tương thích trong tương lai.

Để biết thêm về các vấn đề Node.ownerDocument, xem FAQ DOM của W3C.