Edit Report a Bug

    DOMDocumentFragment::replaceChildren

    (PHP 8 >= 8.3.0)

    DOMDocumentFragment::replaceChildren — Replace children in fragment

    Description

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

    Replaces the children in the document fragment with new nodes.

    Liste de paramètres

    nodes

    The nodes replacing the children. Strings are automatically converted to text nodes.

    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 Calling this method on a node without an owner document now works. Auparavant, cela déclenchait une DOMException avec le code DOM_HIERARCHY_REQUEST_ERR.

    Exemples

    Exemple #1 DOMDocumentFragment::replaceChildren() example

    Replaces the children with new nodes.

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

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

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

    L'exemple ci-dessus va afficher :

    beautiful
<world/>

    Voir aussi

    add a note add a note

    User Contributed Notes

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