XML DOM appendChild() 方法

Node 对象参考手册

定义和用法

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

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

语法:

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

返回值

加入的节点。

描述

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

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

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

例子

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

  1. function appendMessage (message) {
  2. var pElement = document.createElement("p");
  3. var messageNode = document.createTextNode(message);
  4. pElement.appendChild(messageNode);
  5. document.body.appendChild(pElement);
  6. }

实例

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

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

  1. xmlDoc=loadXMLDoc("books.xml");
  2.  
  3. var newel=xmlDoc.createElement('edition');
  4. var newtext=xmlDoc.createTextNode('First');
  5. newel.appendChild(newtext);
  6.  
  7. var x=xmlDoc.getElementsByTagName('book')[0];
  8. x.appendChild(newel);
  9.  
  10. var y=x.childNodes;
  11. for (var i=0;i<y.length;i++)
  12. {
  13. //Display only element nodes
  14. if (y[i].nodeType==1)
  15. {
  16. document.write(y[i].nodeName);
  17. document.write("<br />");
  18. }
  19. }

输出:

  1. title
  2. author
  3. year
  4. price
  5. edition

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

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

Node 对象参考手册