Edit Report a Bug

    DOMNode::appendChild

    (PHP 5, PHP 7, PHP 8)

    DOMNode::appendChild — Añade un nuevo hijo al final de los hijos

    Descripción

    public DOMNode::appendChild(DOMNode $node): DOMNode|false

    Esta función agrega un hijo a una lista existente de hijos o crea una nueva lista de hijos. El hijo se puede crear con, p.ej., DOMDocument::createElement(), DOMDocument::createTextNode() etc. o simplemente usando cualquier otro nodo.

    Si se utiliza un nodo existente, éste se desplazará.

    Parámetros

    node

    El hijo añadido.

    Valores devueltos

    El nodo añadido o false en caso de error.

    Errores/Excepciones

    DOM_NO_MODIFICATION_ALLOWED_ERR

    Lanzado si este nodo es de sólo lectura o si el padre previo del nodo a ser insertado es de sólo lectura.

    DOM_HIERARCHY_REQUEST_ERR

    Lanzado si este nodo es de un tipo de no permite hijos del tipo del nodo node, o si el nodo a añadir es uno de los progenitores del nodo o si es el nodo en sí.

    DOM_WRONG_DOCUMENT_ERR

    Lanzado si node fue creado desde un documento diferente del que creó este nodo.

    Ejemplos

    El siguiente ejemplo añadirá un nuevo nodo elemento a un nuevo documento.

    Ejemplo #1 Añadiendo un hijo

    <?php

    $doc     = new DOMDocument;

    $nodo = $doc->createElement("para");
    $nuevo_nodo = $doc->appendChild($nodo);

    echo     $doc->saveXML();
    ?>

    Ejemplo #2 Hijos anidados

    <?php

    $doc     = new DOMDocument;

    $headNode = $doc->createElement("head");
    $doc->appendChild($headNode);

    $titleNode = $doc->createElement("title");
    $headNode->appendChild($titleNode);

    echo     $doc->saveXML();
    ?>

    Ver también

    add a note add a note

    User Contributed Notes 4 notes

    up
    18
    krisdover at hotmail dot com
    16 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
    7
    cweiske at php dot net
    7 years ago
    If you want to move the children of one node to another, you cannot simply iterate on $element->childNodes - you have to make an array first:

    <?php
    $children     = [];
    foreach (    $elemWithChildren->childNodes as $child) {
            $children[] = $child;
    }
    foreach (    $children as $child) {
            $targetElement->appendChild($child);
    }
    ?>
    up
    3
    jrtayloriv at gmail dot com
    16 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>
    up
    1
    frame at dynamiccreated dot de
    14 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.
    add a note add a note
    To Top