Edit Report a Bug

    DOMParentNode::replaceChildren

    (PHP 8 >= 8.3.0)

    DOMParentNode::replaceChildren — Substitui filhos no nó

    Descrição

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

    Substitui os filhos no nó.

    Parâmetros

    nodes

    Os nós que substituirão os filhos. Strings são automaticamente convertidas em nós de texto.

    Valor Retornado

    Nenhum valor é retornado.

    Erros/Exceções

    DOM_HIERARCHY_REQUEST_ERR

    Emitido se este nó é de um tipo que não permite filhos do tipo de um dos nodes informados, ou se o nó a ser inserido é um dos ancestrais deste nó, ou o próprio nó.

    DOM_WRONG_DOCUMENT_ERR

    Emitido se um dos nodes informados foi criado a partir de um documento diferente daquele que criou este nó.

    Registro de Alterações

    Versão Descrição
    8.3.0 Chamar este método em um nó sem um documento proprietário agora funciona. Anteriormente, era lançada uma exceção DOMException com código DOM_HIERARCHY_REQUEST_ERR.

    Exemplos

    Exemplo #1 DOMParentNode::replaceChildren() exemplo

    <?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();
    ?>

    O exemplo acima produzirá:

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

    User Contributed Notes

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