DOMElement::replaceWith

(PHP 8)

DOMElement::replaceWith — Reemplaza el elemento por nuevos nodos

Descripción

public DOMElement::replaceWith(DOMNode|string ...$nodes): void

Reemplaza el elemento por nuevos nodes.

Parámetros

nodes

Los nodos de reemplazo.

Valores devueltos

No se retorna ningún valor.

Errores/Excepciones

DOM_HIERARCHY_REQUEST_ERR
Se levanta si el padre 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 padre es ahora una operación sin efecto para alinear el comportamiento con la especificación del DOM. Anteriormente, esto desencadenaba una DOMException con el código DOM_HIERARCHY_REQUEST_ERR.

Ejemplos

Ejemplo #1 Ejemplo de DOMElement::replaceWith()

Reemplaza el elemento por nuevos nodos.

<?php
$doc = new DOMDocument;
$doc->loadXML("<container><hello/></container>");
$cdata = $doc->documentElement->firstChild;

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

echo $doc->saveXML();
?>

El ejemplo anterior mostrará:

<?xml version="1.0"?>
<container>beautiful<world/></container>

Ver también