DOMDocument::createElement
(PHP 5)
DOMDocument::createElement — Crée un nouveau noeud
Description
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
namecontient 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
valuene 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
