DOMNode::insertBefore

(PHP 5, PHP 7, PHP 8)

DOMNode::insertBefore 参照しているノードの前に新しい子を追加する

説明

public DOMNode::insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false

この関数は、参照しているノードの直前に新しいノードを挿入します。 追加するノードに対して変更を加えたい場合は、この関数から返される ノードを使用します。

既存のノードを使う場合、そのノードは移動します。

パラメータ

node

新しいノード。

child

参照ノード。指定されなかった場合は、node が子要素として追加されます。

戻り値

挿入されたノードを返します。

エラー / 例外

DOM_NO_MODIFICATION_ALLOWED_ERR

このノードが読み込み専用であったり、挿入されるノードの以前の親が 読み込み専用であった場合に発生します。

DOM_HIERARCHY_REQUEST_ERR

node で指定した型の子ノードを 保持することが許可されていない場合、あるいは追加しようとしている ノードが自分自身やその祖先であった場合に発生します。

DOM_WRONG_DOCUMENT_ERR

node が、このノードとは別の ドキュメントで作成されたものである場合に発生します。

DOM_NOT_FOUND

child がこのノードの子ではない場合に 発生します。

参考

関連キーワード:  ノード, 追加, 参照, DOMNode, , node, 発生, child, 要素, insertBefore