DOMDocument::createAttributeNS

(PHP 5, PHP 7, PHP 8)

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

Descrição

public 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

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