Phương pháp importNode() của HTML DOM Document

Định nghĩa và cách sử dụng

importNode() Phương thức từ tài liệu khác.

Tham số thứ hai được thiết lập thành true thì các phần tử con cũng sẽ được导入.

Lưu ý

Phần tử được导入 sẽ không bị xóa khỏi tài liệu gốc.

Phần tử được导入 là bản sao của phần tử gốc.

Xem thêm:

Phương thức document.adoptNode()

Phương thức element.cloneNode()

Mô hình

Đưa vào từ iframe (tài liệu khác) phần tử <h1> đầu tiên:

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

Thử ngay

Cú pháp

document.importNode(node, deep)

Tham số

Tham số Mô tả
node Bắt buộc. Phần tử từ tài liệu khác.
deep

Bắt buộc.

  • false: Chỉ导入 phần tử本身.
  • true: Các phần tử con (hậu duệ) cũng được导入.

Giá trị trả về

Loại Mô tả
Phần tử Phần tử được导入.

Ném

Nếu node Là phần tử Document hoặc phần tử DocumentType, phương thức này sẽ ném mã là NOT_SUPPORTED_ERR Lỗi DOMException vì không thể导入 các loại phần tử này.

Chi tiết kỹ thuật

Của phương thức này node Tham số là phần tử được định nghĩa trong tài liệu khác, giá trị trả về là bản sao của phần tử phù hợp để chèn vào tài liệu này. Nếu deep Nếu giá trị là true, thì tất cả các phần tử con của phần tử này cũng sẽ được sao chép. Bất kể gì, phần tử gốc và các phần tử con của nó sẽ không bị thay đổi. thuộc tính ownerDocument của bản sao trả về được thiết lập thành tài liệu hiện tại, nhưng thuộc tính parentNode là null vì nó chưa được chèn vào tài liệu. Các hàm lắng nghe sự kiện được đăng ký trong cây phần tử gốc sẽ không được sao chép.

Khi导入 Element phần tử, chỉ có các thuộc tính được thiết lập rõ ràng trong tài liệu nguồn mới được导入. Khi导入 Attr phần tử, thuộc tính specified của nó sẽ tự động được thiết lập thành true.

Hỗ trợ trình duyệt

document.importNode() Là tính năng DOM Level 2 (2001).

Tất cả các trình duyệt đều hỗ trợ nó:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Hỗ trợ 9-11 Hỗ trợ Hỗ trợ Hỗ trợ Hỗ trợ