php[world] in Washington, D.C.

DOMNode::appendChild

(PHP 5)

DOMNode::appendChild Adiciona um novo nó filho ao final dos filhos

Descrição

public DOMNode DOMNode::appendChild ( DOMNode $newnode )

Esta função acrescenta um filho a uma lista existente de filhos, ou cria uma nova lista de filhos. O filho pode ser criado, por exemplo, com a e.g. DOMDocument::createElement(), DOMDocument::createTextNode() etc. ou simplismente pode usar outro nó.

Parâmetros

newnode

Nó anexado.

Valor Retornado

O nó adicionado.

Erros

DOM_NO_MODIFICATION_ALLOWED_ERR

Lençado se este nó é somente leitura, ou se o pai anterior do nó         que está sendo inserido é somente leitura.

DOM_HIERARCHY_REQUEST_ERR

Lançada se este nó é de um tipo que não permite que filhos do        tipo newnode, ou se o nó para acrescentar é um dos antepassados ​​deste nó, ou é este nó em si.

DOM_WRONG_DOCUMENT_ERR

Lançado se newnode foi criado por um documento diferente do documento que criou esse nó.

Exemplos

O exemplo a seguir irá adicionar um novo nó de elemento de um documento novo.

Exemplo #1 Adicionando um nó filho

<?php

$doc 
= new DOMDocument;

$node $doc->createElement("para");
$newnode $doc->appendChild($node);

echo 
$doc->saveXML();
?>

Veja Também

add a note add a note

User Contributed Notes 3 notes

up
1
frame at dynamiccreated dot de
3 years ago
Aware dealing with DOMNodeList and appendChild() on the same Node.

If you want to replace only the children not the DOMElement itself you probably foreach childNodes-property or get the DOMElements with a for-loop and item()-method of the DOMNodeList.

You will fail if you not clone the received single DOMElement. Actually the count of the DOMNodelist will be decreased on appendChild count but appendChild seems to refer to the old Nodelist and nothing visible will happen. Cloning will help.
up
1
krisdover at hotmail dot com
6 years ago
What's not mentioned here is that DOMNode::appendChild() can also be used to move an existing node to another part of the DOMDocument, e.g.

<?php
$doc
= new DOMDocument();
$doc->loadXML("<foobar><bar/><foo/></foobar>");
$bar = $doc->documentElement->firstChild;
$foo = $doc->documentElement->lastChild;
$foo->appendChild($bar);
print
$doc->saveXML();
?>

This produces:

<?xml version="1.0"?>
<foobar><foo><bar/></foo></foobar>

Note that the nodes "<foo/>" and "<bar/>" were siblings, i.e. the first and last child of "<foobar>" but using appendChild() we were able to move "<bar/>" so that it is a child of "<foo/>".

This saves you the trouble of doing a DOMNode::removeChild($bar) to remove "<bar/>" before appending it as a child of "<foo/>".

Kris Dover
up
0
jrtayloriv at gmail dot com
6 years ago
If you want to create nested DOM elements:

<?php
    $doc
= new DOMDocument();
   
   
$foo = $doc->createElement("foo");
   
$doc->appendChild($foo);

   
$bar = $doc->createElement("bar");
   
$foo->appendChild($bar);

   
$bazz = $doc->createElement("bazz");
   
$foo->appendChild($bazz);

    echo
$doc->saveXML();
?>

Is equivalent to:

<foo>
  <bar></bar>
  <bazz></bazz>
</foo>
To Top