DOMElement::replaceWith
(PHP 8)
DOMElement::replaceWith — Replaces the element with new nodes
Beschreibung
Replaces the element with new nodes.
Parameter-Liste
-
nodes -
The replacement nodes. Strings are automatically converted to text nodes.
Rückgabewerte
Es wird kein Wert zurückgegeben.
Fehler/Exceptions
-
DOM_HIERARCHY_REQUEST_ERR -
Wird ausgelöst, wenn der Elternteil von einem Typ ist, der keine Kinder vom Typ eines der übergebenen
nodeszulässt, oder wenn der einzufügende Knoten einer der Vorfahren dieses Knotens oder dieser Knoten selbst ist. -
DOM_WRONG_DOCUMENT_ERR -
Wird ausgelöst, wenn einer der übergebenen
nodesaus einem anderen Dokument erstellt wurde als dem, das diesen Knoten erstellt hat.
Changelog
| Version | Beschreibung |
|---|---|
| 8.3.0 |
Calling this method on a node without a parent is now a no-op to align the behaviour with the DOM specification.
Zuvor führte dies zu einer
DOMException mit dem
Code DOM_HIERARCHY_REQUEST_ERR.
|
Beispiele
Beispiel #1 DOMElement::replaceWith() example
Replaces the element with new nodes.
<?php
$doc = new DOMDocument;
$doc->loadXML("<container><hello/></container>");
$cdata = $doc->documentElement->firstChild;
$cdata->replaceWith("beautiful", $doc->createElement("world"));
echo $doc->saveXML();
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
<?xml version="1.0"?> <container>beautiful<world/></container>
Siehe auch
- DOMChildNode::replaceWith() - Replaces the node with new nodes
- DOMElement::replaceChildren() - Replace children in element
- DOMElement::after() - Adds nodes after the element
- DOMElement::before() - Adds nodes before the element
- DOMElement::remove() - Removes the element
add a note
