« DOMElement
DOMElement::append »

DOMElement::after

(PHP 8)

DOMElement::after — 要素の後ろにノードを追加する

説明

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

渡された nodes を要素の後ろに追加します。

パラメータ

nodes

ノードの後ろに追加されるノード。 文字列は自動的にテキストノードに変換されます。

戻り値

値を返しません。

エラー / 例外

DOM_HIERARCHY_REQUEST_ERR

指定された nodes のうちの一つの子ノードの型を、 親ノードが許可していない場合や、ノードが自分自身やその祖先であった場合に発生します。

DOM_WRONG_DOCUMENT_ERR

指定された nodes のうちの一つが、 このノードを作成したドキュメントとは異なるものから作成された場合に発生します。

変更履歴

バージョン 説明
8.3.0 親がないノードに対して、 このメソッドをコールしても何もしなくなりました。 これは DOM の仕様が要求する振る舞いに合わせるためです。 これより前のバージョンでは、エラーコード DOM_HIERARCHY_REQUEST_ERR を持つ DOMException がスローされていました。
8.3.0 オーナーとなるドキュメントがないノードに対して、 このメソッドをコールしても動作するようになりました。 これより前のバージョンでは、エラーコード DOM_HIERARCHY_REQUEST_ERR を持つ DOMException がスローされていました。

例

例1 DOMElement::after() の例

hello 要素の後ろにノードを追加します

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

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

echo $doc->saveXML();
?>

上の例の出力は以下となります。

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

参考

関連キーワード:
ノード   DOMElement   after   nodes   hello   ドキュメント   エラーコード   DOMException   container   world   append   DOMNode   自動的   テキスト   許可   自分自身   祖先   履歴   仕様   要求   オーナー   DOMDocument   loadXML   documentElement   createElement
関連する関数・ページ:
domelement.append   domelement.before   domelement.prepend   domelement.replacechildren   domelement.replacewith   domelement.remove