DOMElement::replaceWith

(PHP 8)

DOMElement::replaceWith — Замінює елемент новими вузлами

Опис

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

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

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

nodes

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

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

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

Помилки

DOM_HIERARCHY_REQUEST_ERR

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

DOM_WRONG_DOCUMENT_ERR

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

список змін

Версия	Опис
8.3.0	Виклик методу на вузлі без батька тепер заборонено, щоб привести поведінку у відповідність до специфікації DOM. Раніше це викидало виняток DOMException з кодом DOM_HIERARCHY_REQUEST_ERR

Приклади

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

Заміна елемента на нові вузли.

Loading...
▶

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

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

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

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