Edit Report a Bug

DOMDocument::createTextNode

(PHP 5, PHP 7, PHP 8)

DOMDocument::createTextNode — Create new text node

说明

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

This function creates a new instance of class DOMText. 此节点出现在文档中，除非是用诸如 DOMNode->appendChild() 等函数来将其插入。

参数

data: The content of the text.

返回值

The new DOMText.

更新日志

版本	说明
8.1.0	In case of an error, a DomException is thrown now. Previously, `false` was returned.

参见

DOMNode::appendChild() - Adds new child at the end of the children
DOMDocument::createAttribute() - Create new attribute
DOMDocument::createAttributeNS() - Create new attribute node with an associated namespace
DOMDocument::createCDATASection() - Create new cdata node
DOMDocument::createComment() - Create new comment node
DOMDocument::createDocumentFragment() - Create new document fragment
DOMDocument::createElement() - Create new element node
DOMDocument::createElementNS() - Create new element node with an associated namespace
DOMDocument::createEntityReference() - Create new entity reference node
DOMDocument::createProcessingInstruction() - Creates new PI node

add a note

User Contributed Notes 2 notes

down

drewish at katherinehouse dot com ¶

9 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