Crea un nuevo nodo elemento

Descripción

public DOMElement DOMDocument::createElement ( string $name [, string $value ] )

Esta función crea una nueva instancia de la clase DOMElement. Este nodo no se mostrará en el documento a no ser que sea insertado con (p.e.j.) DOMNode::appendChild().

Parámetros

name: El nombre de etiqueta del elemento.
value: El valor del elemento. De manera predeterminada se creará un elemento vacio. El valor también puede ser asignado más tarde con DOMElement::$nodeValue.

Valores devueltos

Devuelve una nueva instanca de la clase DOMElement o FALSE si ha ocurrido un error.

Errores/Excepciones

DOM_INVALID_CHARACTER_ERR: Lanzado si name contiene un carácter inválido.

Ejemplos

Ejemplo #1 Crear un nuevo elemento e insertarlo como raíz


<?php

$dom = new DOMDocument('1.0', 'utf-8');

$element = $dom->createElement('test', 'This is the root element!');

// Insertamos el nuevo elemento como raíz (hijo del documento)
$dom->appendChild($element);

echo $dom->saveXML();
?>

El resultado del ejemplo sería:

<?xml version="1.0" encoding="utf-8"?>
<test>This is the root element!</test>

Notas

Nota:
El parámetro value no será escapado. Utilice DOMDocument::createTextNode() para crear un nodo de texto con soporte para escape de carácteres.

Ver también

DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
DOMDocument::createAttribute() - Crear nuevo attribute
DOMDocument::createAttributeNS() - Crea un nuevo nodo atributo con un namespace asociado.
DOMDocument::createCDATASection() - Crea un nuevo nodo cdata
DOMDocument::createComment() - Crea un nuevo nodo de comentario
DOMDocument::createDocumentFragment() - Crea un nuevo fragmento de documento
DOMDocument::createElementNS() - Crea un nuevo nodo elemento con el nombre de espacio asociado
DOMDocument::createEntityReference() - Create new entity reference node
DOMDocument::createProcessingInstruction() - Crea un nuevo nodo PI
DOMDocument::createTextNode() - Crea un nuevo nodo de texto