DOMDocumentFragment::prepend

(PHP 8)

DOMDocumentFragment::prependAjoute 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 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 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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top