首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

DOMDocument::createElement

(PHP 5, PHP 7)

DOMDocument :: createElement - 创建新的元素节点

描述

代码语言:javascript
复制
public DOMElement DOMDocument::createElement ( string $name [, string $value ] )

这个函数创建一个DOMElement类的新实例。除非使用(例如)DOMNode :: appendChild()插入,否则该节点不会显示在文档中。

参数

name

元素的标签名称。

value

元素的值。默认情况下,将创建一个空元素。该值也可以稍后用DOMElement :: $ nodeValue进行设置。

该值是逐字使用的,只是<和>实体引用会被转义。请注意&必须手动转义; 否则视为启动实体引用。也“不会逃脱。

返回值

返回类DOMElement的新实例或发生错误时返回FALSE

错误/异常

DOM_INVALID_CHARACTER_ERR

如果name包含无效字符则引发。

例子

示例#1创建一个新元素并将其作为根插入

代码语言:javascript
复制
<?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();
?>

上面的例子将输出:

代码语言:javascript
复制
<?xml version="1.0" encoding="utf-8"?>
<test>This is the root element!</test>

示例#2传递包含非转义&as的文本 value

代码语言:javascript
复制
<?php
$dom?=?new?DOMDocument('1.0',?'utf-8');
$element?=?$dom->createElement('foo',?'me?&?you');
$dom->appendChild($element);
echo?$dom->saveXML();
?>

上面的例子会输出类似于:

代码语言:javascript
复制
Warning: DOMDocument::createElement(): unterminated entity reference             you in /in/BjTCg on line 4
<?xml version="1.0" encoding="utf-8"?>
<foo/>

笔记

value不会被转义。使用DOMDocument::createTextNode()来创建具有转义支持的文本节点。

扫码关注腾讯云开发者

领取腾讯云代金券

http://www.vxiaotou.com