« DOMDocument::createDocumentFragmentDOMDocument::createElementNS »PHP ManualDOMDocument

DOMDocument::createElement

(PHP 5, PHP 7, PHP 8)

DOMDocument::createElement — Створює новий вузол елемента

Опис

public DOMDocument::createElement(string $localName, string $value = ""): DOMElement|false

Ця функція створює екземпляр класу DOMElement. Цей вузол не відображатиметься в документі, доки він не буде вставлений, наприклад, функцією DOMNode::appendChild()

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

localName

Ім'я тег елемент.

value

Значення елемента. За промовчанням буде створено порожній елемент. Значення також може бути встановлене пізніше шляхом присвоювання при прямому зверненні до властивості DOMElement::$nodeValue

Значення буде встановлено дослівно, крім символів < і >, які будуть екрановані. Зверніть увагу, що символ & потрібно екранувати самому, інакше він розглядатиметься як початок посилання на суть. Символ кавчок також не буде екранований.

Значення, що повертаються

Повертає новий об'єкт класу DOMElementили**false**в случае возникновения ошибки.

Помилки

DOM_INVALID_CHARACTER_ERR

Виникає, якщо параметр localName містить неприпустимі символи.

Приклади

Приклад #1 Створення нового елемента та вставка його як кореневий

Loading...

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

<?xml version="1.0" encoding="utf-8"?>
<test>Это корневой элемент!</test>

Приклад #2 Надсилання тексту, що містить неекранований & в value

Loading...

Висновок наведеного прикладу буде схожим на:

Warning: DOMDocument::createElement(): unterminated entity reference             you in /in/BjTCg on line 4
<?xml version="1.0" encoding="utf-8"?>
<foo/>

Примітки

Зауваження :

Значениеvalue не буде екрановано. Використовуйте функцію DOMDocument::createTextNode() для створення текстового вузла з підтримкою екранування

Дивіться також