DOMDocument::createElement

public DOMDocument::createElement(string $localName, [string $value]): DOMElement
```php

Esta función crea una nueva instancia de la clase `DOMElement`. Este nodo no será mostrado en el documento, a menos que sea insertado con `DOMNode::appendChild`.

## Parámetros

`localName`  
El nombre de etiqueta del elemento.

`value`  
El valor del elemento. De manera predeterminada se creará un elemento vacio. El valor también puede ser asignado más tarde con [DOMElement::\$nodeValue](#domnode.props.nodevalue).

El valor es usado al pie de la letra, excepto que las referencias de entidad \< y \> se escaparán. Tenga en cuenta que & tiene que ser escapado manualmente; de lo contrario, se tomará como inicio de una referencia de entidad. Además " no sera escapado.

## Valores devueltos

Devuelve una nueva instanca de la clase `DOMElement` o `false` si ha ocurrido un error.

## Errores/Excepciones

Puede lanzar una DOMException con los siguientes códigos de error:

`DOM_INVALID_CHARACTER_ERR`  
Lanzado si `localName` contiene un carácter inválido.

## Ejemplos

Crear un nuevo elemento e insertarlo como raíz

El ejemplo anterior mostrará:

Pasando texto que contiene un & sin escapar como `valor`

Warning: DOMDocument::createElement(): unterminated entity reference             you in /in/BjTCg on line 4

<foo/>