PHP Conference Japan 2024

DOMElement::replaceWith

(PHP 8)

DOMElement::replaceWith使用新的節點取代元素

說明

public DOMElement::replaceWith(DOMNode|字串 ...$nodes): void

使用新的 nodes 取代元素。

參數

nodes

取代節點。字串會自動轉換為文字節點。

回傳值

無回傳值。

錯誤/例外

DOM_HIERARCHY_REQUEST_ERR

如果父節點的類型不允許其中一個傳入的 nodes 節點類型作為子節點,或者如果要放入的節點是此節點的祖先節點或此節點本身,則會引發此錯誤。

DOM_WRONG_DOCUMENT_ERR

如果其中一個傳入的 nodes 節點是從與建立此節點不同的文件建立的,則會引發此錯誤。

更新日誌

版本 說明
8.3.0 現在,在沒有父節點的節點上呼叫此方法將不會執行任何操作,以使行為與 DOM 規範一致。先前,這會丟出一個程式碼為 DOM_HIERARCHY_REQUEST_ERRDOMException 例外。

範例

範例 #1 DOMElement::replaceWith() 範例

使用新的節點取代元素。

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

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

echo
$doc->saveXML();
?>

上述範例將輸出:

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

另請參閱

新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。
To Top