DOMDocument::createTextNode

(PHP 5, PHP 7, PHP 8)

DOMDocument::createTextNode — Crée un nouveau nœud de texte

Description

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

Cette fonction crée une nouvelle instance de la classe DOMText. Ce nœud ne sera pas affiché dans le document, à moins qu'il ne soit inséré avec DOMNode::appendChild().

Liste de paramètres

data: Le contenu du texte.

Valeurs de retour

Un nouveau DOMText.

Historique

Version	Description
8.1.0	En cas d'erreur, une DomException est désormais lancée. Auparavant, `false` était retourné.

Voir aussi

DOMNode::appendChild() - Ajoute un nouveau fils à la fin des fils
DOMDocument::createAttribute() - Crée un nouvel attribut
DOMDocument::createAttributeNS() - Crée un nouvel attribut avec un espace de noms associé
DOMDocument::createCDATASection() - Crée un nouveau nœud cdata
DOMDocument::createComment() - Crée un nouveau nœud de commentaire
DOMDocument::createDocumentFragment() - Crée un nouveau fragment de document
DOMDocument::createElement() - Crée un nouveau nœud
DOMDocument::createElementNS() - Crée un nouveau nœud avec un espace de noms associé
DOMDocument::createEntityReference() - Crée un nouveau nœud de référence d'entité
DOMDocument::createProcessingInstruction() - Crée un nouveau nœud PI

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