Inserta un elemento adyacente

# DOMElement::insertAdjacentElement

(PHP 8 >= 8.3.0)

DOMElement::insertAdjacentElement — Inserta un elemento adyacente

### Descripción

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

Inserta un elemento en una posición relativa dada por `where`.

### Parámetros

`where`

  - `beforebegin` - Inserta antes del elemento objetivo.
  - `afterbegin` - Inserta como primer hijo del elemento objetivo.
  - `beforeend` - Inserta como último hijo del elemento objetivo.
  - `afterend` - Inserta después del elemento objetivo.
`element`

  El elemento a insertar.

### Valores devueltos

Devuelve DOMElement o `null` en caso de fallo.

### Ejemplos

Ejemplo #1 Ejemplo de 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();
    ?>

El ejemplo anterior mostrará:

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

### Ver también

- DOMElement::insertAdjacentText() - Inserta un texto adyacente

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