DOMDocument::createTextNode

(PHP 5, PHP 7, PHP 8)

DOMDocument::createTextNodeCreate new text node

Description

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

This function creates a new instance of class DOMText. This node will not show up in the document unless it is inserted with (e.g.) DOMNode::appendChild().

Parameters

data

The content of the text.

Return Values

The new DOMText.

Changelog

Version Description
8.1.0 In case of an error, a DomException is thrown now. Previously, false was returned.

See Also

add a note add a note

User Contributed Notes 2 notes

up
9
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.
up
1
Alex Kaye
15 years ago
A quick note to anyone who is using character entities (e.g. ©) 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);
?>
To Top