XML DOM appendChild() 方法

Node 对象参考手册

定义和用法

appendChild() 方法可向节点的子节点列表的末尾添加新的子节点。

此方法可返回这个新的子节点。

语法:

appendChild(newchild)
参数 描述
newchild 所添加的节点

返回值

加入的节点。

描述

该方法将把节点 newchild 添加到文档中,使它成为当前节点的最后一个子节点。

如果文档树中已经存在了 newchild,它将从文档树中删除,然后重新插入它的新位置。如果 newchild 是 DocumentFragment 节点,则不会直接插入它,而是把它的子节点按序插入当前节点的 childNodes[] 数组的末尾。

注意,来自一个文档的节点(或由一个文档创建的节点)不能插入另一个文档。也就是说,newchild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。

例子

下面的函数将在文档末尾插入一个新段:

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

实例

在所有的例子中,我们将使用 XML 文件 books.xml,以及 JavaScript 函数 loadXMLDoc()

下面的代码片段可创建并向首个 <book> 元素添加一个节点,然后输出首个 <book> 元素的所有子节点:

xmlDoc=loadXMLDoc("books.xml");

var newel=xmlDoc.createElement('edition');
var newtext=xmlDoc.createTextNode('First');
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 />");
    } 
  }

输出:

title
author
year
price
edition

注释:Internet Explorer 会忽略节点间生成的空白文本节点(例如,换行符号),而 Mozilla 不会这样做。因此,在下面的例子中,我们仅处理元素节点(元素节点的 nodeType=1)。

提示:如需更多有关 IE 与 Mozilla 浏览器之间 XML DOM 的差异的内容,请访问我们的 DOM 浏览器 章节。

Node 对象参考手册

目录