(PHP 8)
DOMDocumentFragment::prepend — Prepends nodes before the first child node
Prepends one or many nodes to the list of children before the first child node.
nodesThe nodes to prepend. Strings are automatically converted to text nodes.
Es wird kein Wert zurückgegeben.
DOM_HIERARCHY_REQUEST_ERR
Wird ausgelöst, wenn dieser Knoten von einem Typ ist, der keine Kinder vom
Typ eines der übergebenen nodes zulässt, oder wenn
der einzufügende Knoten einer der Vorfahren dieses Knotens oder dieser
Knoten selbst ist.
DOM_WRONG_DOCUMENT_ERR
Wird ausgelöst, wenn einer der übergebenen nodes aus
einem anderen Dokument erstellt wurde als dem, das diesen Knoten erstellt hat.
| Version | Beschreibung |
|---|---|
| 8.3.0 |
Calling this method on a node without an owner document now works.
Zuvor führte dies zu einer
DOMException mit dem
Code DOM_HIERARCHY_REQUEST_ERR.
|
Beispiel #1 DOMDocumentFragment::prepend() example
Prepends nodes before the fragment root.
<?php
$doc = new DOMDocument;
$fragment = $doc->createDocumentFragment();
$fragment->appendChild($doc->createElement("world"));
$fragment->prepend($doc->createElement("hello"), "beautiful");
echo $doc->saveXML($fragment);
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
<hello/>beautiful<world/>