DOMElement::insertAdjacentElement

(PHP 8 >= 8.3.0)

DOMElement::insertAdjacentElement — 隣接する要素を挿入する

説明

public function DOMElement::insertAdjacentElement(string $where, DOMElement $element): ?DOMElement

where で指定された相対的な位置に、要素を挿入します。

パラメータ

where

beforebegin - 目的の要素の直前に挿入します
afterbegin - 目的の要素の最初の子要素として挿入します
beforeend - 目的の要素の最後の子要素として挿入します
afterend - 目的の要素の直後に挿入します

element

挿入する要素

戻り値

DOMElement を返します。失敗した場合は null を返します。

例

例1 DOMElement::insertAdjacentElement() の例

<?php

$dom = new DOMDocument();
$dom->loadXML('<?xml version="1.0"?><container><p>foo</p></container>');
$container = $dom->documentElement;
$p = $container->firstElementChild;

$p->insertAdjacentElement('beforebegin', $dom->createElement('A'));
echo $dom->saveXML();
?>

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

<?xml version="1.0"?>
<container><A/><p>foo</p></container>

参考

DOMElement::insertAdjacentText() - 隣接するテキストを挿入する

関連キーワード:

DOMElement 挿入 container insertAdjacentElement 隣接目的 insertAdjacentText element beforebegin hasAttributeNS 相対的 afterbegin 最初 beforeend 最後 afterend 直後 DOMDocument loadXML documentElement firstElementChild createElement saveXML 参考テキスト