JavaScript: The Definitive Guide

2017-07-07 02:10:07

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

DOM Level 2 Core:

25.60.1. Synopsis

Attr createAttributeNS(String namespaceURI, String qualifiedName) throws DOMException;

25.60.1.1. 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.

25.60.1.2. Returns

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

25.60.1.3. 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.

25.60.2. 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.