DOMDocumentFragment::prepend

(PHP 8)

DOMDocumentFragment::prepend在第一个子节点之前预置节点

描述

public DOMDocumentFragment::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 DOMDocumentFragment::prepend() 示例

在片段根节点之前预置节点。

<?php
$doc
= new DOMDocument;
$fragment = $doc->createDocumentFragment();
$fragment->appendChild($doc->createElement("world"));

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

echo
$doc->saveXML($fragment);
?>

以上示例将输出

<hello/>beautiful<world/>

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top