PHP Conference Japan 2024

DOMElement::before

(PHP 8)

DOMElement::before在元素之前添加节点

描述

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

在元素之前添加传递的 nodes

参数

nodes

要在节点之前添加的节点。字符串会自动转换为文本节点。

返回值

不返回值。

错误/异常

DOM_HIERARCHY_REQUEST_ERR

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

DOM_WRONG_DOCUMENT_ERR

如果传递的 nodes 之一是由与此节点创建的文档不同的文档创建的,则引发此异常。

变更日志

版本 描述
8.3.0 现在,对没有父级的节点调用此方法将不再执行任何操作,以使行为与 DOM 规范保持一致。以前,这会抛出一个代码为 DOM_HIERARCHY_REQUEST_ERRDOMException

示例

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

在 hello 元素之前添加节点。

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

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

echo
$doc->saveXML();
?>

以上示例将输出

hello
<beautiful/>
<world/>

参见

添加注释

用户贡献注释

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