Edit Report a Bug

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() - 新しい comment ノードを作成する
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