在线文档教程
PHP
HTML

DOMDocument::createElement

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/>

笔记