DOMDocumentFragment::prepend
(PHP 8)
DOMDocumentFragment::prepend — Prepends nodes before the first child node
Description
Prepends one or many nodes to the list of children before the first child node.
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
nodestransmis, 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
nodestransmis 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 DOMDocumentFragment::prepend() example
Prepends nodes before the fragment root.
<?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
- DOMParentNode::prepend() - Ajoute des nœuds avant le premier nœud enfant
- DOMDocumentFragment::append() - Appends nodes after the last child node
add a note
