W3cubDocs

/Web APIs

Document: createAttributeNS() method

The Document.createAttributeNS() method creates a new attribute node with the specified namespace URI and qualified name, and returns it. The object created is a node implementing the Attr interface. The DOM does not enforce what sort of attributes can be added to a particular element in this manner.

Syntax

createAttributeNS(namespaceURI, qualifiedName)

Parameters

namespaceURI: A string that specifies the namespace URI to associate with the attribute. The namespaceURI property of the created attribute is initialized with the value of namespaceURI. See Valid Namespace URIs.
qualifiedName: A string that specifies the name of attribute to be created. The name property of the created attribute is initialized with the value of qualifiedName.

Return value

The new Attr node.

Exceptions

NamespaceError DOMException: Thrown if the namespaceURI value is not a valid namespace URI.
InvalidCharacterError DOMException: Thrown if the qualifiedName value is not a valid XML name; for example, it starts with a number, hyphen, or period, or contains characters other than alphanumeric characters, underscores, hyphens, or periods.

Important Namespace URIs

HTML: http://www.w3.org/1999/xhtml
SVG: http://www.w3.org/2000/svg
MathML: http://www.w3.org/1998/Math/MathML

Examples

const node = document.getElementById("svg");
const a = document.createAttributeNS("http://www.w3.org/2000/svg", "viewBox");
a.value = "0 0 100 100";
node.setAttributeNode(a);
console.log(node.getAttribute("viewBox")); // "0 0 100 100"

Specifications

Specification
DOM Standard # dom-document-createattributens

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`createAttributeNS`	1	12	1	9	≤12.1	1	4.4	18	4	≤12.1	1	1.0