DOMElement::prepend

(PHP 8)

DOMElement::prepend在第一个子节点之前添加节点

描述

public DOMElement::prepend(DOMNode|string ...$nodes): void

在第一个子节点之前,将一个或多个 nodes 添加到子节点列表中。

参数

nodes

要添加的节点。字符串将自动转换为文本节点。

返回值

不返回值。

错误/异常

DOM_HIERARCHY_REQUEST_ERR

如果此节点的类型不允许传递的 nodes 类型中的一个的子节点,或者如果要放入的节点是此节点的祖先之一或此节点本身,则引发此错误。

DOM_WRONG_DOCUMENT_ERR

如果传递的 nodes 中的一个是使用与创建此节点的文档不同的文档创建的,则引发此错误。

变更日志

版本 描述
8.3.0 现在,在没有所有者文档的节点上调用此方法将起作用。以前,这会抛出 DOMException,其代码为 DOM_HIERARCHY_REQUEST_ERR

示例

示例 #1 DOMElement::prepend() 示例

在容器元素中添加节点。

<?php
$doc
= new DOMDocument;
$doc->loadXML("<container> world</container>");
$world = $doc->documentElement;

$world->prepend($doc->createElement("hello"), "beautiful");

echo
$doc->saveXML();
?>

上面的示例将输出

<?xml version="1.0"?>
<container><hello/>beautiful world</container>

参见

添加说明

用户贡献说明

此页面没有用户贡献的说明。
To Top