DOMDocument::createTextNode

(PHP 5, PHP 7, PHP 8)

DOMDocument::createTextNode — Cria novo nó de texto

Descrição

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

Esta função cria uma nova instância da classe DOMText. Este nó não aparecerá no documento a menos que seja inserido, por exemplo, com DOMNode::appendChild().

Parâmetros

data: O conteúdo do texto.

Valor Retornado

A nova instância de DOMText.

Registro de Alterações

Versão	Descrição
8.1.0	Em caso de erro, agora é lançada uma DomException. Anteriormente, retornava `false`.

Veja Também

DOMNode::appendChild() - Adiciona um novo filho ao final dos filhos
DOMDocument::createAttribute() - Cria um novo attribute
DOMDocument::createAttributeNS() - Cria um novo nó de atributo com um namespace associado
DOMDocument::createCDATASection() - Cria um novo nó de CDATA
DOMDocument::createComment() - Cria novo nó de comentárioe
DOMDocument::createDocumentFragment() - Cria novo fragmento de documento
DOMDocument::createElement() - Cria novo nó de elemento
DOMDocument::createElementNS() - Cria novo nó de elemento com um namespace associado
DOMDocument::createEntityReference() - Cria novo nó de referência de entidade
DOMDocument::createProcessingInstruction() - Cria novo nó PI (Processing Instruction)

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