PHP Conference Japan 2024

DOMParentNode::replaceChildren

(PHP 8 >= 8.3.0)

DOMParentNode::replaceChildrenRemplace les enfants dans un nœud

Description

public DOMParentNode::replaceChildren(DOMNode|string ...$nodes): void

Remplace les enfants dans un nœud.

Liste de paramètres

nodes

Les nœuds remplaçant les enfants. Les chaînes de caractères sont automatiquement converties en nœuds 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 DOMParentNode::replaceChildren()

<?php

$dom
= new DOMDocument();
$dom->loadHTML('<!DOCTYPE HTML><html><p>hi</p> test <p>hi2</p></html>');

$dom->documentElement->replaceChildren('foo', $dom->createElement('p'), 'bar');
echo
$dom->saveXML();
?>

L'exemple ci-dessus va afficher :

<?xml version="1.0" standalone="yes"?>
<!DOCTYPE HTML>
<html>foo<p/>bar</html>
add a note

User Contributed Notes

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