Cria um novo nó de atributo com um namespace associado

# DOMDocument::createAttributeNS

(PHP 5, PHP 7, PHP 8)

DOMDocument::createAttributeNS — Cria um novo nó de atributo com um namespace associado

### Descrição

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

Esta função cria uma nova instância da classe DOMAttr. Este nó não aparecerá no documento a menos que seja inserido, por exemplo, com DOMNode::appendChild().

### Parâmetros

`namespace`

  O URI do namespace.

`qualifiedName`

  O nome qualificado e o prefixo do atributo, como `prefix:tagname`.

### Valor Retornado

O novo DOMAttr ou `false` se ocorrer um erro.

### Erros/Exceções

Pode lançar um DOMException com os seguintes códigos de erro:

`DOM_INVALID_CHARACTER_ERR`

  Gerado se `qualifiedName` contiver um caractere inválido.

`DOM_NAMESPACE_ERR`

  Gerado se `qualifiedName` for um nome qualificado malformado ou se `qualifiedName` tiver um prefixo e `namespace` for `null`.

### Registro de Alterações

Versão | Descrição
--- | ---
8.3.0 | Chamar este método sem especificar um prefixo agora escolherá um prefixo em vez de assumir o namespace padrão. Anteriormente, isso criaria um atributo sem prefixo e aplicaria incorretamente o namespace ao elemento pai porque os namespaces padrão não se aplicam a atributos.
8.3.0 | Chamar este método usando um prefixo que já foi declarado no elemento pai com um URI de namespace diferente agora mudará o novo prefixo para evitar criar conflitos de namespace. Isso alinha o comportamento com a especificação DOM. Anteriormente, isso lançava uma DOMException com o código `DOM_NAMESPACE_ERR`.

### Veja Também

- DOMNode::appendChild() - Adiciona um novo filho ao final dos filhos
- DOMDocument::createAttribute() - Cria um novo attribute
- DOMDocument::createCDATASection() - Cria um novo nó de CDATA
- DOMDocument::createComment() - Cria novo nó de comentárioe
- DOMDocument::createDocumentFragment() - Cria novo fragmento de documento
- DOMDocument::createElement() - Cria novo nó de elemento
- DOMDocument::createElementNS() - Cria novo nó de elemento com um namespace associado
- DOMDocument::createEntityReference() - Cria novo nó de referência de entidade
- DOMDocument::createProcessingInstruction() - Cria novo nó PI (Processing Instruction)
- DOMDocument::createTextNode() - Cria novo nó de texto

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