(PHP 8)
DOMDocumentFragment::prepend — 在第一個子節點之前新增節點
在第一個子節點之前，將一個或多個 nodes 新增到子節點列表中。
nodes要新增的節點。字串會自動轉換為文字節點。
不回傳任何值。
DOM_HIERARCHY_REQUEST_ERR如果此節點的類型不允許其中一個傳入的 nodes 類型的子節點，或者如果要放入的節點是此節點的祖先或此節點本身，則會引發此錯誤。
DOM_WRONG_DOCUMENT_ERR如果其中一個傳入的 nodes 是從與建立此節點不同的文件建立的，則會引發此錯誤。
| 版本 | 說明 |
|---|---|
| 8.3.0 | 現在可以在沒有擁有者文件 (owner document) 的節點上呼叫此方法。先前呼叫此方法會拋出程式碼為 DOM_HIERARCHY_REQUEST_ERR 的 DOMException 例外。 |
範例 #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/>