DOMDocument::createElement

(PHP 5, PHP 7)

DOMDocument::createElement — Create new element node

Descrierea

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

This function creates a new instance of class DOMElement. Acest nod nu va apărea în document dacă nu este inserat cu DOMNode::appendChild() de exemplu.

Parametri

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.

The value is used verbatim except that the < and > entity references will escaped. Note that & has to be manually escaped; otherwise it is regarded as starting an entity reference. Also " won't be escaped.

Valorile întoarse

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

Erori/Excepții

DOM_INVALID_CHARACTER_ERR

Raised if name contains an invalid character.

Exemple

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();
?>

Exemplul de mai sus va afișa:

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

Example #2 Passing text containing an unescaped & as value

<?php
$dom = new DOMDocument('1.0', 'utf-8');
$element = $dom->createElement('foo', 'me & you');
$dom->appendChild($element);
echo $dom->saveXML();
?>

Exemplul de mai sus va afișa ceva similar cu:

Warning: DOMDocument::createElement(): unterminated entity reference             you in /in/BjTCg on line 4
<?xml version="1.0" encoding="utf-8"?>
<foo/>

Note

Notă:

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

A se vedea și