Home/ Manual/ dom / domdocument/ DOMDocument::createAttributeNS

DOMDocument::createAttributeNS

PHP function Edit on GitHub ✎

(PHP 5, PHP 7, PHP 8)

Create new attribute node with an associated namespace

Description

DOMDocument::createAttributeNS(string|null $namespace, string $qualifiedName): DOMAttr|false

This function creates a new instance of class DOMAttr. Inserted

namespace: The URI of the namespace.
qualifiedName: The tag name and prefix of the attribute, as prefix:tagname.

The new DOMAttr or false if an error occurred.

May throw a DOMException with the following error codes:

DOM_INVALID_CHARACTER_ERR: Raised if qualifiedName contains an invalid character.
DOM_NAMESPACE_ERR: Raised if qualifiedName is a malformed qualified name, or if qualifiedName has a prefix and namespace is null.

Version	Description
8.3.0	Calling this method without specifying a prefix will now choose a prefix instead of assuming the default namespace. Previously this would create an attribute without a prefix and incorrectly apply the namespace to the owner element because default namespaces don't apply on attributes.
8.3.0	Calling this method using a prefix that was already declared on the owner element with a different namespace URI will now change the new prefix to avoid creating namespace conflicts. This aligns the behaviour with the DOM specification. Previously this threw a `DOMException` with code `DOM_NAMESPACE_ERR`.