【PHP8.x】beforeメソッドの使い方

DOMCharacterDataクラスのbeforeメソッドは、ノードの前（兄弟ノードとして）にノードまたは文字列を挿入するメソッドです。具体的には、このメソッドは、DOMCharacterDataオブジェクト（例えば、テキストノードやコメントノード）の直前に、指定されたノードまたは文字列を新しい兄弟ノードとして挿入します。

このメソッドは、挿入する内容としてノードまたは文字列を受け取ります。ノードを挿入する場合、そのノードはドキュメントツリーから切り離され、新しい位置に挿入されます。文字列を挿入する場合は、その文字列を内容とする新しいテキストノードが作成され、挿入されます。

beforeメソッドは、元のDOMCharacterDataオブジェクトが属するドキュメントツリーを変更します。挿入操作が成功すると、DOMCharacterDataオブジェクトの親ノードの子ノードリストが更新され、新しいノードまたはテキストノードが適切な位置に挿入されます。

insertBeforeメソッドと似ていますが、insertBeforeメソッドが特定のノードの「前」に挿入するのに対し、beforeメソッドは対象ノード自体の「前」に挿入する点が異なります。ノード操作において、より直感的で簡潔な記述を可能にするために導入されました。このメソッドは、DOMツリーの構造を動的に変更する際に非常に役立ちます。例えば、テキストノードの内容を更新したり、新しいテキストノードを既存のテキストノードの前に追加したりするなどの操作が可能です。

Copy
1<?php
2$document = new DOMDocument();
3$parent = $document->createElement('div');
4$textNode = $document->createTextNode('world');
5$parent->appendChild($textNode);
6
7// DOMCharacterData::before ( DOMNode|string ...$nodes ) : void
8$textNode->before($document->createTextNode('Hello '), 'Beautiful ');
9?>

DOMNode|string ...$nodes

• DOMNode|string $nodes: 指定したノードまたは文字列。これらのノードまたは文字列が、このノードの前に挿入されます。

void

このメソッドは、指定したノードをこのノードの直前に挿入します。戻り値はありません。