Element: setAttributeNS() method

setAttributeNS adds a new attribute or changes the value of an attribute with the given namespace and name.

If you are working with HTML documents and you don't need to specify the requested attribute as being part of a specific namespace, use the setAttribute() method instead.

Syntax

js
setAttributeNS(namespace, name, value)

Parameters

  • namespace is a string specifying the namespace of the attribute.
  • name is a string identifying the attribute by its qualified name; that is, a namespace prefix followed by a colon followed by a local name.
  • value is the desired string value of the new attribute.

Return value

None (undefined).

Examples

js
let d = document.getElementById("d1");
d.setAttributeNS(
  "http://www.mozilla.org/ns/specialspace",
  "spec:align",
  "center",
);

Notes

setAttributeNS is the only method for namespaced attributes which expects the fully qualified name, i.e. "namespace:localname".

Specifications

Specification
DOM Standard
# ref-for-dom-element-setattributens①

Browser compatibility

BCD tables only load in the browser

See also