Crée un nouveau noeud

Description

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

Cette fonction crée une nouvelle instance de la classe DOMElement. Ce noeud ne sera pas affiché dans le document, à moins qu'il ne soit inséré avec DOMNode::appendChild().

Liste de paramètres

name: Le nom du tag de l'élément.
value: La valeur de l'élément. Par défaut, un élément vide sera créé. La valeur peut également être définie plus tard avec la fonction DOMElement::$nodeValue.

Valeurs de retour

Retourne une nouvelle instance de la classe DOMElement ou FALSE si une erreur survient.

Erreurs / Exceptions

DOM_INVALID_CHARACTER_ERR: Lancé si name contient un caractère invalide.

Exemples

Exemple #1 Création d'un nouvel élément et insertion en tant que racine


<?php

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

$element = $dom->createElement('test', 'Ceci est l\'élément racine !');

// Nous insérons le nouvel élément en tant que racine (enfant du document)
$dom->appendChild($element);

echo $dom->saveXML();
?>

L'exemple ci-dessus va afficher :

<?xml version="1.0" encoding="iso-8859-1"?>
<test>Ceci est l'élément racine !</test>

Notes

Note:
La valeur value ne sera pas échappée. Utilisez la méthode DOMDocument::createTextNode() pour créer un nœud de texte avec le support de l'échappement.

Voir aussi

DOMNode::appendChild() - Ajoute un nouveau fils à la fin des fils
DOMDocument::createAttribute() - Crée un nouvel attribut
DOMDocument::createAttributeNS() - Crée un nouvel attribut avec un espace de noms associé
DOMDocument::createCDATASection() - Crée un nouveau noeud cdata
DOMDocument::createComment() - Crée un nouveau noeud de commentaire
DOMDocument::createDocumentFragment() - Crée un nouveau fragment de document
DOMDocument::createElementNS() - Crée un nouveau noeud avec un espace de noms associé
DOMDocument::createEntityReference() - Crée un nouveau noeud de référence d'entité
DOMDocument::createProcessingInstruction() - Crée un nouveau noeud PI
DOMDocument::createTextNode() - Crée un nouveau noeud de texte