(PHP 8)
DOMDocumentFragment::prepend — Добавляет узлы перед первым дочерним узлом
Добавляет один или несколько узлов nodes в список дочерних узлов перед первым дочерним узлом.
nodesУзлы, которые необходимо добавить. Строки автоматически преобразуются в текстовые узлы.
Функция не возвращает значения после выполнения.
DOM_HIERARCHY_REQUEST_ERR
Возникает, если тип одного из переданных в параметре nodes элементов не допускается в типе узла,
или если добавляемый узел является одним из предков этого узла или самим этим узлом.
DOM_WRONG_DOCUMENT_ERR
Возникает, если один из переданных в параметре nodes элементов был создан из документа,
отличного от того, в котором был создан этот узел.
| Версия | Описание |
|---|---|
| 8.3.0 |
Вызов этого метода на узле без документа владельца теперь работает.
Раньше метод выбрасывал исключение
DOMException с кодом
DOM_HIERARCHY_REQUEST_ERR.
|
Пример #1 Пример использования метода DOMDocumentFragment::prepend()
Добавление узлов перед корнем фрагмента.
<?php
$doc = new DOMDocument;
$fragment = $doc->createDocumentFragment();
$fragment->appendChild($doc->createElement("world"));
$fragment->prepend($doc->createElement("hello"), "beautiful");
echo $doc->saveXML($fragment);
?>Результат выполнения приведённого примера:
<hello/>beautiful<world/>