DOMElement::prepend

(PHP 8)

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

Description

public function 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 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 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 nœuds après le dernier enfant

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.