DOMElement::replaceChildren
(PHP 8 >= 8.3.0)
DOMElement::replaceChildren — Substitui filhos no elemento
Descrição
Substitui os filhos no elemento com novos nodes
.
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
Example #1 DOMElement::replaceChildren() exemplo
Substitui os filhos com novos nodes.
<?php
$doc = new DOMDocument;
$doc->loadXML("<container><hello/></container>");
$container = $doc->documentElement;
$container->replaceWith("beautiful", $doc->createElement("world"));
echo $doc->saveXML();
?>
O exemplo acima produzirá:
<?xml version="1.0"?> beautiful <world/>
Veja Também
- DOMParentNode::replaceChildren() - Substitui filhos no nó
- DOMElement::replaceWith() - Substitui o elemento por novos nodes
- DOMElement::after() - Adiciona nós após o elemento
- DOMElement::before() - Adiciona nós antes do elemento
- DOMElement::remove() - Remove o elemento