Metode XML DOM appendChild()

Panduan Referensi Objek Node

Definisi dan penggunaan

Metode appendChild() dapat menambahkan node anak baru ke daftar anak node.

Metode ini dapat mengembalikan node anak baru.

Sintaks

appendChild(newchild)
Parameter Deskripsi
newchild Node yang ditambahkan

Kembalian nilai

Node yang disisipkan.

Deskripsi

Metode ini akan menambahkan node newchild ke dokumen, menjadikannya anak terakhir node saat ini.

Jika newchild sudah ada di pohon dokumen, ia akan dihapus dari pohon dokumen dan diisipkan kembali ke posisi baru. Jika newchild adalah node DocumentFragment, ia tidak akan disisipkan langsung, tetapi semua anaknya akan disisipkan berurutan ke akhir daftar childNodes[] node saat ini.

Perhatikan, node dari dokumen yang sama (atau node yang dibuat oleh dokumen) tidak dapat disisipkan ke dokumen lain. Artinya, atribut ownerDocument newchild harus sama dengan atribut ownerDocument node saat ini.

Contoh

Fungsi di bawah ini akan menambahkan paragraf baru di akhir dokumen:

function appendMessage (message) {
  var pElement = document.createElement("p");
  var messageNode = document.createTextNode(message);
  pElement.appendChild(messageNode);
  document.body.appendChild(pElement);
}

Contoh

Dalam semua contoh, kita akan menggunakan berkas XML books.xmldan fungsi JavaScript loadXMLDoc()

Blok kode di bawah ini dapat mencipta dan menambahkan sebuah node ke elemen pertama <book>, lalu menampilkan semua node anak elemen pertama <book>:

xmlDoc=loadXMLDoc("books.xml");
var newel=xmlDoc.createElement('edisi');
var newtext=xmlDoc.createTextNode('Pertama');
newel.appendChild(newtext);
var x=xmlDoc.getElementsByTagName('book')[0];
x.appendChild(newel);;
var y=x.childNodes;
for (var i=0;i<y.length;i++)
  { 
  //Display only element nodes
  if (y[i].nodeType==1)
    { 
    document.write(y[i].nodeName);
    document.write("<br />");
    } 
  }

Output:

title
author
year
price
edition

Keterangan:Internet Explorer akan mengabaikan node teks kosong yang dihasilkan antara node (seperti simbol garis baru), sementara Mozilla tidak melakukan hal ini. Oleh karena itu, di contoh di bawah ini, kami hanya mengolah node elemen (node elemen nodeType=1).

Petunjuk:Untuk informasi lebih lanjut tentang perbedaan DOM XML antara IE dan peramban Mozilla, silakan kunjungi Peramban DOM Bab.

Panduan Referensi Objek Node