JavaScript: The Definitive Guide, Fourth Edition

Name

Document.createAttributeNS( ) — create an Attr with a name and namespace

Availability

DOM Level 2 Core

Synopsis

Attr createAttributeNS(String namespaceURI, 
                       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.