DOMParentNode::replaceChildren

(PHP 8 >= 8.3.0)

DOMParentNode::replaceChildren — Заменяет потомков в узле

Описание

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

Заменяет потомков в узле.

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

nodes: Узлы, которыми будут заменены потомки. Строки автоматически преобразовываются в текстовые узлы.

Возвращаемые значения

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

Ошибки

DOM_HIERARCHY_REQUEST_ERR: Возникает, если тип одного из переданных в параметре nodes элементов не допускается в типе узла, или если добавляемый узел является одним из предков этого узла или самим этим узлом.
DOM_WRONG_DOCUMENT_ERR: Возникает, если один из переданных в параметре nodes элементов был создан из документа, отличного от того, в котором был создан этот узел.

Список изменений

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

Примеры

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

<?php

$dom = new DOMDocument();
$dom->loadHTML('<!DOCTYPE HTML><html><p>Привет!</p> проверка <p>Снова привет!</p></html>');

$dom->documentElement->replaceChildren('foo', $dom->createElement('p'), 'bar');
echo $dom->saveXML();
?>

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

<?xml version="1.0" standalone="yes"?>
<!DOCTYPE HTML>
<html>foo<p/>bar</html>

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы