DOMDocument::createElement
新しい要素ノードを作成する
&reftitle.description;
public DOMElementfalseDOMDocument::createElement
stringlocalName
stringvalue""
この関数は、DOMElement
クラスの新しいインスタンスを作成します。
&dom.node.inserted;
&reftitle.parameters;
localName
要素のタグ名。
value
要素の値。デフォルトでは、空の要素が作成されます。
その後に DOMElement::$nodeValue
で値を設定することも可能です。
指定した値はすべてそのまま用いますが、エンティティ参照 < と >
だけはエスケープします。& は手動でエスケープする必要があることに注意しましょう。
そうしないと、エンティティ参照の開始とみなされてしまいます。また、" はエスケープされません。
&reftitle.returnvalues;
新しい DOMElement クラスの新しいインスタンス、
あるいはエラーが発生した場合は &false; を返します。
&reftitle.errors;
以下のエラーコードで DOMException
をスローします:
DOM_INVALID_CHARACTER_ERR
localName が無効な文字を含んでいる場合に発生します。
&reftitle.examples;
新しい要素を作成し、ルートとして挿入する
createElement('test', 'This is the root element!');
// 新しい要素をルート (ドキュメントの子要素) として挿入する
$dom->appendChild($element);
echo $dom->saveXML();
?>
]]>
&example.outputs;
This is the root element!
]]>
& をエスケープせずに value に渡す例
createElement('foo', 'me & you');
$dom->appendChild($element);
echo $dom->saveXML();
?>
]]>
&example.outputs.similar;
]]>
&reftitle.notes;
value は エスケープされません。
エスケープに対応した テキストノードを作るには
DOMDocument::createTextNode を使います。
&reftitle.seealso;
DOMNode::appendChild
DOMDocument::createAttribute
DOMDocument::createAttributeNS
DOMDocument::createCDATASection
DOMDocument::createComment
DOMDocument::createDocumentFragment
DOMDocument::createElementNS
DOMDocument::createEntityReference
DOMDocument::createProcessingInstruction
DOMDocument::createTextNode