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

『beforeメソッドは、特定のDOM要素の直前に、一つまたは複数の新しいノードや文字列を挿入する処理を実行するメソッドです。このメソッドは、操作の基準となるDOMElementオブジェクトから呼び出します。引数には、挿入したいDOMNodeオブジェクトまたは文字列を渡すことができます。引数は複数指定することが可能で、その場合は指定された順序で基準要素の前に追加されます。もし引数として文字列が渡された場合、その文字列は自動的にテキストノード（DOMText）に変換されてDOMツリーに挿入されます。このメソッドを利用することで、例えば特定の要素のすぐ上に新しい兄弟要素を追加するといった操作を、親ノードを取得せずに直接的かつ簡潔に記述できます。従来のDOMNode::insertBeforeメソッドに比べて、より直感的なコードでDOM構造を操作できる点が特徴です。なお、このメソッドに返り値はありません。

Copy
1<?php
2
3// HTMLを読み込み、DOMDocumentオブジェクトを生成します
4$dom = new DOMDocument();
5$dom->loadHTML('
6  <div>
7    <p id="target_element">この要素が基準になります。</p>
8  </div>
9');
10
11// IDを使って基準となる要素を取得します
12$target = $dom->getElementById('target_element');
13
14// 新しく挿入する<h1>要素を作成します
15$newHeading = $dom->createElement('h1', '新しい見出し');
16
17// 基準となる要素の直前に、新しい<h1>要素とテキスト文字列を挿入します
18$target->before($newHeading, 'ここにテキストが追加されます。');
19
20// 変更後のHTMLを出力します
21echo $dom->saveHTML();
22
23?>

DOMNode|string ...$nodes

• DOMNode|string $nodes: 指定した要素の前に挿入するノード、またはHTML文字列。複数指定可能。

void

DOMElementオブジェクトの前に新しいノードを挿入しますが、このメソッドは値を返しません。