隣接する要素を挿入する

# 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() - 隣接するテキストを挿入する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open