JavaScript: The Definitive Guide, 5th Edition

Name

Document.createAttributeNS( ): create an Attr with a name and namespace — DOM Level 2 Core:

Synopsis

Attr createAttributeNS(StringnamespaceURI,
                       String qualifiedName)
    throws DOMException;

Arguments

namespaceURI

The unique identifier of the namespace for the Attr or null for no namespace.

qualifiedName

The qualified name of the attribute, which should include a namespace prefix, a colon, and a local name.

Returns

A newly created Attr node with the specified name and namespace.

Throws

This method may throw a DOMException with one of the following code values in the following circumstances:

INVALID_CHARACTER_ERR

qualifiedName contains an illegal character.

NAMESPACE_ERR

qualifiedName is malformed or there is a mismatch between qualifiedName and namespaceURI.

NOT_SUPPORTED_ERR

The implementation does not support XML documents and therefore does not implement this method.

Description

createAttributeNS( ) is just like createAttribute( ), except that the created Attr node has a name and namespace instead of just a name. This method is useful only with XML documents that use namespaces.