PHP 8.4.2 Released!

DOMElement::replaceChildren

(PHP 8 >= 8.3.0)

DOMElement::replaceChildrenReplace children in element

Опис

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

Replaces the children in the element with new nodes.

Параметри

nodes

The nodes replacing the children. Strings are automatically converted to text nodes.

Значення, що повертаються

Не повертає значень.

Помилки/виключення

DOM_HIERARCHY_REQUEST_ERR

Виникає, якщо тип цього вузла не дозволяє тип дочірнього вузла, котрий передано в параметр nodes, або якщо вузол, який потрібно додати, є одним із предків цього вузла або ним самим.

DOM_WRONG_DOCUMENT_ERR

Виникає, якщо один з переданих nodes було створено не в тому документі, що і цей вузол.

Журнал змін

Версія Опис
8.3.0 Calling this method on a node without an owner document now works. Раніше викидалося виключення DOMException з кодом DOM_HIERARCHY_REQUEST_ERR.

Приклади

Приклад #1 DOMElement::replaceChildren() example

Replaces the children with new nodes.

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

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

echo
$doc->saveXML();
?>

Поданий вище приклад виведе:

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

Прогляньте також

add a note

User Contributed Notes

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