PHP Conference Japan 2024

DOMElement::before

(PHP 8)

DOMElement::before在元素之前新增節點

說明

public DOMElement::before(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::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