DOMDocument::createElement

(PHP 5)

DOMDocument::createElement — Create new element node

Descrição

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

This function creates a new instance of class DOMElement. Este nó não será exibido no documento a não ser que ele seja inserido, por exemplo, com DOMNode->appendChild().

Parâmetros

name

The tag name of the element.

value

The value of the element. By default, an empty element will be created. The value can also be set later with DOMElement::$nodeValue.

Valor Retornado

Returns a new instance of class DOMElement or FALSE if an error occurred.

Erros

DOM_INVALID_CHARACTER_ERR

Raised if name contains an invalid character.

Exemplos

Example #1 Creating a new element and inserting it as root

<?php

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

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

// We insert the new element as root (child of the document)
$dom->appendChild($element);

echo $dom->saveXML();
?>

O exemplo acima irá imprimir:

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

Notas

Note:

The value will not be escaped. Use DOMDocument::createTextNode() to create a text node with escaping support.

Veja Também