Documentación offline PHP master
/

DOMDocument::createElementNS

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

DOMDocument::createElementNS

Crea un nuevo nodo elemento con el nombre de espacio asociado

Descripción#

public DOMDocument::createElementNS(string $namespace, string $qualifiedName, [string $value]): DOMElement
```php

Esta función crea un nuevo nodo elemento con el nombre de espacio asociado. Este nodo no será mostrado en el documento, a menos que sea insertado con `DOMNode::appendChild`.

## Parámetros

`namespace`  
El URI del nombre de espacio.

`qualifiedName`  
Elo nombre cualificado del elemento, como `prefix:tagname`.

`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).

## Valores devueltos

El nuevo `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 `qualifiedName` contiene un carácter inválido.

`DOM_NAMESPACE_ERR`  
Lanzado si `qualifiedName` es un nombre cualificado mal formado.

## Ejemplos

Crear un nuevo elemento e insertarlo como raíz
createElementNS('http://www.example.com/XFoo', 'xfoo:test', 'This is the root element!'); // Insertamos el nuevo elemento como raíz (hijo del documento) $dom->appendChild($element); echo $dom->saveXML(); ?> 
El ejemplo anterior mostrará:

This is the root element!

Un ejemplo de prefijo de nombre de espacio
formatOutput = true; $root = $doc->createElementNS('http://www.w3.org/2005/Atom', 'element'); $doc->appendChild($root); $root->setAttributeNS('http://www.w3.org/2000/xmlns/' ,'xmlns:g', 'http://base.google.com/ns/1.0'); $item = $doc->createElementNS('http://base.google.com/ns/1.0', 'g:item_type', 'house'); $root->appendChild($item); echo $doc->saveXML(), "\n"; echo $item->namespaceURI, "\n"; // Imprime: http://base.google.com/ns/1.0 echo $item->prefix, "\n"; // Imprime: g echo $item->localName, "\n"; // Imprime: item_type ?> 
El ejemplo anterior mostrará:

house

http://base.google.com/ns/1.0 g item_type

```php

Véase también#

DOMNode::appendChild, DOMDocument::createAttribute, DOMDocument::createAttributeNS, DOMDocument::createCDATASection, DOMDocument::createComment, DOMDocument::createDocumentFragment, DOMDocument::createElement, DOMDocument::createEntityReference, DOMDocument::createProcessingInstruction, DOMDocument::createTextNode