HTML DOM Dokumen kaedah importNode()

Definisi dan penggunaan

importNode() Metode mengimpor node dari dokumen lain.

parameter kedua diatur menjadi true Jika

Petunjuk

Node yang diimpor tidak akan dihapus dari dokumen asli.

Node yang diimpor adalah salinan node asli.

Lihat pula:

Metode document.adoptNode()

Metode element.cloneNode()

Contoh

Mengimpor elemen <h1> pertama dari iframe (dokumen lain):

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

Coba sendiri

Sintaks

document.importNode(node, deep)

Parameter

Parameter Deskripsi
node Diperlukan. Node dari dokumen lain.
deep

Diperlukan.

  • false: Hanya node itu sendiri yang diimpor.
  • true: Node turunan (turunan) juga diimpor.

Nilai kembalikan

Tipe Deskripsi
Node node yang diimpor.

melempar

Jika node Adalah node Document atau node DocumentType, metodenya akan melempar kode NOT_SUPPORTED_ERR ecception DOMException, karena tak dapat mengimpor jenis node ini.

Rincian teknis

Fungsi ini node Parameter adalah node yang didefinisikan di dalam dokumen lain, nilai kembalikan adalah salinan node yang cocok untuk disisipkan ke dokumen ini. Jika deep Jika nilai adalah true, maka seluruh node turunannya juga akan disalin. Namun demikian, node asli dan seluruh node turunannya tidak akan diubah. Properti ownerDocument yang kembalikan diset ke dokumen saat ini, tetapi properti parentNode adalah null, karena belum disisipkan ke dokumen. Fungsi pendengar peristiwa yang didaftarkan di dalam tree node asli tidak akan disalin.

Ketika mengimpor node Element, hanya properti yang diset di dokumen sumber yang akan diimpor. Ketika mengimpor node Attr, secara otomatis mengatur properti specifiednya menjadi true.

Pendukung pelayar

document.importNode() Adalah fitur DOM Level 2 (2001).

Semua pelayar web mendukungnya:

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