DOMDocument::createElement

    (PHP 5, PHP 7, PHP 8)

    DOMDocument::createElement — Crée un nouveau nœud

    Description

    publicDOMDocument::createElement(string$localName, string$value = ""): DOMElement|false

    Cette fonction crée une nouvelle instance de la classe DOMElement. Ce nœud 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é. De plus " ne sera pas échappé.

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

    Résultat de l'exemple ci-dessus est 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 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

    To Top