array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'domdocumentfragment.prepend.php', 1 => 'DOMDocumentFragment::prepend', 2 => 'Ajoute des nœuds avant le premier nœud enfant', ), 'up' => array ( 0 => 'class.domdocumentfragment.php', 1 => 'DOMDocumentFragment', ), 'prev' => array ( 0 => 'domdocumentfragment.construct.php', 1 => 'DOMDocumentFragment::__construct', ), 'next' => array ( 0 => 'domdocumentfragment.replacechildren.php', 1 => 'DOMDocumentFragment::replaceChildren', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/dom/domdocumentfragment/prepend.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

DOMDocumentFragment::prepend

(PHP 8)

DOMDocumentFragment::prepend — Ajoute des nœuds avant le premier nœud enfant

Description

public DOMDocumentFragment::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 converties 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 DOMDocumentFragment::prepend()

Ajoute des nœuds avant le fragment racine.

<?php
$doc = new DOMDocument;
$fragment = $doc->createDocumentFragment();
$fragment->appendChild($doc->createElement("world"));

$fragment->prepend($doc->createElement("hello"), "beautiful");

echo $doc->saveXML($fragment);
?>

L'exemple ci-dessus va afficher :

<hello/>beautiful<world/>

Voir aussi