DOMElement::before

(PHP 8)

DOMElement::beforeAdds nodes before the element

Опис

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

Adds the passed nodes before the element.

Параметри

nodes

Nodes to be added before the node. Strings are automatically converted to text nodes.

Значення, що повертаються

Не повертає значень.

Помилки/виключення

DOM_HIERARCHY_REQUEST_ERR

Виникає, якщо тип батьківського вузла не дозволяє тип дочірнього вузла, котрий передано в параметр nodes, або якщо вузол, який потрібно додати, є одним із предків цього вузла або ним самим.

DOM_WRONG_DOCUMENT_ERR

Виникає, якщо один з переданих nodes було створено не в тому документі, що і цей вузол.

Журнал змін

Версія Опис
8.3.0 Calling this method on a node without a parent is now a no-op to align the behaviour with the DOM specification. Раніше викидалося виключення DOMException з кодом DOM_HIERARCHY_REQUEST_ERR.

Приклади

Приклад #1 DOMElement::before() example

Adds nodes before the hello element.

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

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

echo
$doc->saveXML();
?>

Поданий вище приклад виведе:

hello
<beautiful/>
<world/>

Прогляньте також

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top