DOMDocument::createElement
(PHP 5, PHP 7)
DOMDocument :: createElement - 创建新的元素节点
描述
public DOMElement DOMDocument::createElement ( string $name [, string $value ] )
这个函数创建一个DOMElement类的新实例。除非使用(例如)DOMNode :: appendChild()插入,否则该节点不会显示在文档中。
参数
name
元素的标签名称。
value
元素的值。默认情况下,将创建一个空元素。该值也可以稍后用DOMElement :: $ nodeValue进行设置。
该值是逐字使用的,只是<和>实体引用会被转义。请注意&必须手动转义; 否则视为启动实体引用。也“不会逃脱。
返回值
返回类DOMElement的新实例或发生错误时返回FALSE
。
错误/异常
DOM_INVALID_CHARACTER_ERR
如果name
包含无效字符则引发。
例子
示例#1创建一个新元素并将其作为根插入
<?php
$dom?=?new?DOMDocument('1.0',?'utf-8');
$element?=?$dom->createElement('test',?'This?is?the?root?element!');
//?We?insert?the?new?element?as?root?(child?of?the?document)
$dom->appendChild($element);
echo?$dom->saveXML();
?>
上面的例子将输出:
<?xml version="1.0" encoding="utf-8"?>
<test>This is the root element!</test>
示例#2传递包含非转义&as的文本 value
<?php
$dom?=?new?DOMDocument('1.0',?'utf-8');
$element?=?$dom->createElement('foo',?'me?&?you');
$dom->appendChild($element);
echo?$dom->saveXML();
?>
上面的例子会输出类似于:
Warning: DOMDocument::createElement(): unterminated entity reference you in /in/BjTCg on line 4
<?xml version="1.0" encoding="utf-8"?>
<foo/>
笔记
注:
本
value
将不会被转义。使用DOMDocument::createTextNode()来创建具有转义支持的文本节点。
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com