DOMNode::appendChild
(PHP 5, PHP 7, PHP 8)
DOMNode::appendChild — Додає новий дочірній вузол у кінець списку нащадків
Опис
public DOMNode::appendChild(DOMNode $node): DOMNode|false
Функція додає дочірній вузол до існуючого списку нащадків або створює новий список дочірніх елементів. Дочірній вузол може бути створений за допомогою DOMDocument::createElement() DOMDocument::createTextNode() і т.д., або може бути використаний будь-який інший вузол.
При використанні існуючого вузла його буде переміщено.
Список параметрів
node
Дочірній вузол, що додається.
Значення, що повертаються
Повертає доданий вузол або **false**в случае возникновения ошибки.
Помилки
DOM_NO_MODIFICATION_ALLOWED_ERR
Виникає, якщо вузол доступний тільки для читання або попередній батько вузла, що вставляється, доступний тільки для читання.
DOM_HIERARCHY_REQUEST_ERR
Виникає, якщо тип вузла не підтримує нащадків типу, що має вузол node, або якщо вузол, що додається, є одним з предком цільового вузла або ним самим.
DOM_WRONG_DOCUMENT_ERR
Виникає, якщо node створено іншому документі, відмінному від цього, у якому було створено цей вузол.
Приклади
Наступний приклад додає новий вузол у щойно створений документ.
Приклад #1 Додавання дочірнього вузла
Приклад #2 Вкладені дочірні вузли
Дивіться також
- DOMChildNode::after() - Додає вузли після вузла
- DOMNode::insertBefore() - Додає новий дочірній вузол перед вказаним вузлом
- DOMNode::removeChild() - видаляє дочірній вузол зі списку нащадків
- DOMNode::replaceChild() - Замінює дочірній вузол