DOMElement::replaceChildren

(PHP 8 >= 8.3.0)

DOMElement::replaceChildren — Замінює дочірні елементи в елементі

Опис

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

Замінює дочірні елементи елемента новими вузлами nodes

Список параметрів

nodes

Вузли, якими будуть замінені нащадки. Рядки автоматично перетворюються на текстові вузли.

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

Функція не повертає значення після виконання.

Помилки

DOM_HIERARCHY_REQUEST_ERR

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

DOM_WRONG_DOCUMENT_ERR

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

список змін

Версия	Опис
8.3.0	Виклик методу на вузлі без документа власника працює. Раніше це викидало виняток DOMException з кодом DOM_HIERARCHY_REQUEST_ERR

Приклади

Приклад #1 Приклад использования методаDOMElement::replaceChildren()****

Заміна дочірніх вузлів на нові.

Loading...
▶

Результат виконання наведеного прикладу:

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

Дивіться також

• DOMParentNode::replaceChildren() - Замінює нащадків у вузлі
• DOMElement::replaceWith() - Замінює елемент новими вузлами
• DOMElement::after() - Додає вузли після елемента
• DOMElement::before() - Додає вузли перед елементом
• DOMElement::remove() - Видаляє елемент