PHPerKaigi 2024

DOMElement::after

(PHP 8)

DOMElement::afterAdds nodes after the element

Beschreibung

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

Adds the passed nodes after the element.

Parameter-Liste

nodes

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

Rückgabewerte

Es wird kein Wert zurückgegeben.

Fehler/Exceptions

DOM_HIERARCHY_REQUEST_ERR

Wird ausgelöst, wenn der Elternteil 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.

Changelog

Version Beschreibung
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. Zuvor führte dies zu einer DOMException mit dem Code DOM_HIERARCHY_REQUEST_ERR.
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.

Beispiele

Beispiel #1 DOMElement::after() example

Adds nodes after the hello element.

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

$container->after("beautiful", $doc->createElement("world"));

echo
$doc->saveXML();
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Siehe auch

add a note

User Contributed Notes

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