DOMNode::appendChild
(PHP 5, PHP 7)
DOMNode::appendChild — Добавляет новый дочерний узел в конец списка потомков
Описание
Функция добавляет дочерний узел в существующий список потомков или создает новый список дочерних элементов. Дочерний узел может быть создан с помощью DOMDocument::createElement(), DOMDocument::createTextNode() и т.д., или может быть использован любой другой узел.
При использовании существующего узла он будет перемещен.
Список параметров
-
newnode -
Добавляемый дочерний узел.
Возвращаемые значения
Добавленный узел.
Ошибки
-
DOM_NO_MODIFICATION_ALLOWED_ERR -
Возникает, если узел доступен только для чтения или предыдущий родитель вставляемого узла доступен только для чтения.
-
DOM_HIERARCHY_REQUEST_ERR -
Возникает, если тип узла не поддерживает потомков типа, который имеет узел
newnode, или если добавляемый узел является одним из предком целевого узла или им самим. -
DOM_WRONG_DOCUMENT_ERR -
Возникает, если
newnodeсоздан в другом документе, отличном от того, в котором был создан этот узел.
Примеры
Следующий пример добавляет новый узел в только что созданный документ.
Пример #1 Добавление дочернего узла
<?php
$doc = new DOMDocument;
$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);
echo $doc->saveXML();
?>
Пример #2 Вложенные дочерние узлы
<?php
$doc = new DOMDocument;
$headNode = $doc->createElement("head");
$doc->appendChild($headNode);
$titleNode = $doc->createElement("title");
$headNode->appendChild($titleNode);
echo $doc->saveXML();
?>
Смотрите также
- DOMNode::insertBefore() - Добавляет новый дочерний узел перед указанным узлом
- DOMNode::removeChild() - Удаляет дочерний узел из списка потомков
- DOMNode::replaceChild() - Заменяет дочерний узел