DOMDocument::createElement - Создает новый узел-элемент
Вернуться к: DOMDocument
DOMDocument::createElement
(PHP 5, PHP 7)
DOMDocument::createElement — Создает новый узел-элемент
Описание
Эта функция создает экземпляр класса DOMElement. Этот узел не будет отображаться в документе до тех пор, пока он не будет вставлен, например, функцией DOMNode::appendChild().
Список параметров
-
name -
Имя элемента.
-
value -
Значение элемента. По умолчанию будет создан пустой элемент. Значение может быть установлено позднее с помощью функции DOMElement::$nodeValue.
Возвращаемые значения
Возвращает новый объект класса DOMElement либо
FALSE в случае ошибки.
Ошибки
-
DOM_INVALID_CHARACTER_ERR -
Возникает, если
nameсодержит недопустимые символы.
Примеры
Пример #1 Создание нового элемента и вставка его в качестве корневого
<?php
$dom = new DOMDocument('1.0', 'utf-8');
$element = $dom->createElement('test', 'This is the root element!');
// Вставляем новый элемент как корень (потомок документа)
$dom->appendChild($element);
echo $dom->saveXML();
?>
Результат выполнения данного примера:
<?xml version="1.0" encoding="utf-8"?> <test>Это корневой элемент!</test>
Примечания
Замечание:
Значение
valueне будет экранировано. Используйте функцию DOMDocument::createTextNode() для создания узла с текстовым содержимым с поддержкой экранирования.
Смотрите также
- DOMNode::appendChild() - Добавляет новый дочерний узел в конец списка потомков
- DOMDocument::createAttribute() - Создает новый атрибут
- DOMDocument::createAttributeNS() - Создает новый узел-атрибут с соответствующим ему пространством имен
- DOMDocument::createCDATASection() - Создает новый cdata узел
- DOMDocument::createComment() - Создает новый узел-комментарий
- DOMDocument::createDocumentFragment() - Создание фрагмента документа
- DOMDocument::createElementNS() - Создание нового узла-элемента с соответствующим пространством имен
- DOMDocument::createEntityReference() - Создание нового узла-ссылки на сущность
- DOMDocument::createProcessingInstruction() - Создает новый PI-узел
- DOMDocument::createTextNode() - Создает новый текстовый узел
Вернуться к: DOMDocument