DOMDocument::createElement
(PHP 5, PHP 7)
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 DOMElement::$nodeValue.
La valeur est utilisé textuellement à l'exception des références d'entités < et > qui seront échappées. Notez que & doit être échappé manuellement ; sinon ceci est considéré comme le début d'une référence d'entité. Deplus " ne sera pas échappé.
Valeurs de retour
Retourne une nouvelle instance de la classe
DOMElement ou FALSE
si une erreur survient.
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="utf-8"?> <test>Ceci est l'élément racine !</test>
Exemple #2 Passer comme value du texte contenant & non échappé
<?php
$dom = new DOMDocument('1.0', 'utf-8');
$element = $dom->createElement('foo', 'me & you');
$dom->appendChild($element);
echo $dom->saveXML();
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Warning: DOMDocument::createElement(): unterminated entity reference you in /in/BjTCg on line 4 <?xml version="1.0" encoding="utf-8"?> <foo/>
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
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-domdocument.createelement.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
