DOMDocument::createTextNode

(PHP 5, PHP 7, PHP 8)

DOMDocument::createTextNode — Создать новый текстовый узел

Описание

public DOMDocument::createTextNode(string $data): DOMText

Эта функция создаёт экземпляр класса DOMText. Этот узел не будет отображаться в документе до тех пор, пока он не будет вставлен, например, функцией DOMNode::appendChild().

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

data: Содержимое узла.

Возвращаемые значения

Возвращает новый объект класса DOMText.

Список изменений

Версия	Описание
8.1.0	В случае возникновения ошибки теперь выбрасывает исключение DomException. Ранее вместо этого возвращалось значение `false`.

Смотрите также

DOMNode::appendChild() - Добавляет новый дочерний узел в конец списка потомков
DOMDocument::createAttribute() - Создаёт новый атрибут
DOMDocument::createAttributeNS() - Создаёт новый атрибут узла с соответствующим пространством имён
DOMDocument::createCDATASection() - Создаёт новый узел cdata
DOMDocument::createComment() - Создать новый узел комментария
DOMDocument::createDocumentFragment() - Создаёт новый фрагмент документа
DOMDocument::createElement() - Создаёт новый узел элемента
DOMDocument::createElementNS() - Создать новый узел элемента с соответствующим пространством имён
DOMDocument::createEntityReference() - Создать новый узел ссылки на сущность
DOMDocument::createProcessingInstruction() - Создать новый PI-узел

add a note

User Contributed Notes 2 notes

down

drewish at katherinehouse dot com ¶

10 years ago


The docs don't mention it but this method performs escaping on the value. If you don't want that use createElement() instead.

down

Alex Kaye ¶

15 years ago


A quick note to anyone who is using character entities (e.g. &copy;) in this, and finding them automatically escaped. The correct thing to do here is to use the createEntityReference method (e.g. createEntityReference("copy");), and then appendChild this entity between text nodes.



Example:



<?php

$copyright_text_1 = $this->document->createTextNode("Copyright ");

$copyright_text_2 = $this->document->createTextNode(" Alex Kaye 2009");

$copyright_symbol = $this->document->createEntityReference("copy");

$copyright->appendChild($copyright_text_1);

$copyright->appendChild($copyright_symbol);

$copyright->appendChild($copyright_text_2);

?>

add a note