【PHP8.x】appendChildメソッドの使い方
appendChildメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
appendChildメソッドは、XMLやHTMLドキュメントの要素が持つ属性を表すDom\Attrオブジェクトに、新しい子ノードを追加するメソッドです。Dom\Attrは、例えば<div id="myId">におけるid="myId"のような、要素の付加情報(属性)を表します。
このメソッドを使用すると、指定された子ノードをDom\Attrオブジェクトの子ノードリストの末尾に追加することができます。通常、Dom\Attrオブジェクトに子として追加されるのは、属性の値を構成するDom\Textノード(テキストデータ)です。例えば、属性値「myId」を表現するDom\Textノードを作成し、このメソッドでDom\Attrオブジェクトに追加することで、プログラムから属性値を設定したり変更したりすることが可能になります。
引数には、追加したい子ノードとなるDom\Node型のオブジェクトを指定します。追加に成功した場合、このメソッドは追加されたノード自身を返します。もし指定されたノードがすでにドキュメントツリー内の別の場所にある場合、そのノードは元の位置から削除され、新しい親であるDom\Attrオブジェクトの子として移動します。これにより、ノードの再配置を簡単に行うことができます。このappendChildメソッドは、XMLやHTMLのDOM(Document Object Model)を操作し、ドキュメントの構造や内容を動的に変更するための基本的な機能として非常に重要です。
構文(syntax)
1<?php 2 3$dom = new DOMDocument(); 4$attr = $dom->createAttribute('data-value'); 5$textNode = $dom->createTextNode('exampleText'); 6 7$attr->appendChild($textNode);
引数(parameters)
Dom\Node $node
- Dom\Node $node: 追加する子ノードを指定します
戻り値(return)
Dom\Node
appendChildメソッドは、指定されたノードを現在の属性ノードの子ノードとして追加します。このメソッドは、追加された子ノードであるDom\Nodeオブジェクトを返します。