Remplace les enfants dans le fragment

# DOMDocumentFragment::replaceChildren

(PHP 8 >= 8.3.0)

DOMDocumentFragment::replaceChildren — Remplace les enfants dans le fragment

### Description

public function DOMDocumentFragment::replaceChildren(DOMNode|string `...$nodes`): void

Remplace les enfants dans le fragment par de nouveaux `nodes`.

### 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 DOMDocumentFragment::replaceChildren()

Remplace les enfants par de nouveaux nœuds.

    <?php
    $doc = new DOMDocument;
    $doc->loadXML("<container><hello/></container>");
    $fragment = $doc->createDocumentFragment();
    $fragment->append("hello");

    $fragment->replaceChildren("beautiful", $doc->createElement("world"));

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

L'exemple ci-dessus va afficher :

    beautiful
    <world/>

### Voir aussi

- DOMParentNode::replaceChildren() - Remplace les enfants dans un nœud
- DOMDocumentFragment::append() - Ajoute des nœuds après le dernier nœud enfant
- DOMDocumentFragment::prepend() - Ajoute des nœuds avant le premier nœud enfant

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open