DOMElement::replaceChildren

(PHP 8 >= 8.3.0)

DOMElement::replaceChildren替换元素中的子节点

描述

public DOMElement::replaceChildren(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::replaceChildren() 示例

用新的节点替换子节点。

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

$container->replaceWith("beautiful", $doc->createElement("world"));

echo
$doc->saveXML();
?>

上述示例将输出

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

参见

添加注释

用户贡献的注释

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