Crea un nuevo atributo con un espacio de nombres asociado

# DOMDocument::createAttributeNS

(PHP 5, PHP 7, PHP 8)

DOMDocument::createAttributeNS — Crea un nuevo atributo con un espacio de nombres asociado

### Descripción

public function DOMDocument::createAttributeNS(?string `$namespace`, string `$qualifiedName`): DOMAttr|false

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

### Parámetros

`namespace`

  El URI del espacio de nombres.

`qualifiedName`

  El nombre de la etiqueta y el prefijo del atributo, en este formato: `prefijo:nombreEtiqueta`.

### Valores devueltos

El nuevo DOMAttr o `false` si ocurre 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 o si `qualifiedName` tiene un sufijo y `namespace` es `null`.

### Historial de cambios

Versión | Descripción
--- | ---
8.3.0 | Llamar a este método sin especificar un prefijo elegirá ahora un prefijo en lugar de asumir el espacio de nombres por defecto. Anteriormente, esto creaba un atributo sin prefijo y aplicaba incorrectamente el espacio de nombres al elemento propietario ya que los espacios de nombres por defecto no se aplican a los atributos.
8.3.0 | Llamar a este método utilizando un prefijo ya declarado en el elemento propietario con un URI de espacio de nombres diferente cambiará ahora el nuevo prefijo para evitar conflictos de espacio de nombres. Esto alinea el comportamiento con la especificación del DOM. Anteriormente, esto lanzaba una DOMException con el código `DOM_NAMESPACE_ERR`.

### Ver también

- DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
- DOMDocument::createAttribute() - Crea un nuevo atributo
- DOMDocument::createCDATASection() - Crea un nuevo nodo cdata
- DOMDocument::createComment() - Crea un nuevo nodo de comentario
- DOMDocument::createDocumentFragment() - Crea un nuevo fragmento de documento
- DOMDocument::createElement() - Crea un nuevo nodo elemento
- DOMDocument::createElementNS() - Crea un nuevo nodo elemento con el nombre de espacio asociado
- DOMDocument::createEntityReference() - Create new entity reference node
- DOMDocument::createProcessingInstruction() - Crea un nuevo nodo PI
- DOMDocument::createTextNode() - Crea un nuevo nodo de texto

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