# DOMElement::prepend

(PHP 8)

DOMElement::prepend — Ajoute des noeuds avant le premier enfant

### Description

public DOMElement::prepend(DOMNode|string `...$nodes`): void

Ajoute un ou plusieurs `nodes` à la liste des enfants avant le premier nœud enfant.

### Liste de paramètres

`nodes`

  Les nœuds à ajouter. Les chaînes de caractères sont automatiquement convertie en des nœuds de texte.

### Valeurs de retour

Aucune valeur n'est retournée.

### Erreurs / Exceptions

`DOM_HIERARCHY_REQUEST_ERR`

  Levée si ce nœud est d'un type qui n'autorise pas les enfants du type de l'un des `nodes` transmis, ou si le nœud à insérer est l'un des ancêtres de ce nœud ou ce nœud lui-même.

`DOM_WRONG_DOCUMENT_ERR`

  Levée si l'un des `nodes` transmis a été créé à partir d'un document différent de celui qui a créé ce nœud.

### Historique

Version | Description
--- | ---
8.3.0 | Appeler cette méthode sur un nœud sans document propriétaire fonctionne désormais. Auparavant, cela déclenchait une DOMException avec le code `DOM_HIERARCHY_REQUEST_ERR`.

### Exemples

Exemple #1 Exemple de DOMElement::prepend()

Ajoute les nœuds avant l'élément conteneur.

`<?php
$doc = new DOMDocument;
$doc->loadXML("<container> world</container>");
$world = $doc->documentElement;
$world->prepend($doc->createElement("hello"), "beautiful");
echo $doc->saveXML();
?>`

L'exemple ci-dessus va afficher :

    <?xml version="1.0"?>
    <container><hello/>beautiful world</container>

### Voir aussi

- DOMParentNode::prepend() - Ajoute des nœuds avant le premier nœud enfant
- DOMElement::append() - Ajoute des noeuds après le dernier enfant