DOMParentNode::replaceChildren

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#

Reemplaza los hijos en un nodo

Descripción#

public DOMParentNode::replaceChildren(DOMNode ...$nodes): void
```php

Reemplaza los hijos en un nodo.

## Parámetros

`nodes`  
Los nodos que reemplazan a los hijos. Las cadenas de caracteres se convierten automáticamente en nodos de texto.

## Valores devueltos

No se retorna ningún valor.

## Errores/Excepciones

`DOM_HIERARCHY_REQUEST_ERR`  
Se levanta si este nodo es de un tipo que no permite hijos del tipo de uno de los `nodes` transmitidos, o si el nodo a insertar es uno de los ancestros de este nodo o este nodo mismo.

`DOM_WRONG_DOCUMENT_ERR`  
Se levanta si uno de los `nodes` transmitidos ha sido creado a partir de un documento diferente del que creó este nodo.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.3.0 | Llamar a este método en un nodo sin documento propietario funciona ahora. Anteriormente, esto desencadenaba una `DOMException` con el código `DOM_HIERARCHY_REQUEST_ERR`. |

## Ejemplos

Ejemplo de DOMParentNode::replaceChildren

loadHTML('

test

hi2

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

```php

El ejemplo anterior mostrará:

<!DOCTYPE HTML>
<html>foo<p/>bar</html>