web api instance method
Document: createAttribute() method
The createAttribute() method of the Document interface creates a new attribute node.
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.
[!NOTE] The string given in parameter is converted to lowercase.
Syntax
createAttribute(localName)
Parameters
localName- : A string containing the name of the attribute.
The value is used to initialize the new attribute’s
localNameproperty.
- : A string containing the name of the attribute.
The value is used to initialize the new attribute’s
Return value
An Attr node.
Exceptions
InvalidCharacterErrorDOMException-
: Thrown if the
localNamevalue is not a valid attribute name. It must have at least one character, and may not contain ASCII whitespace,NULL,/,=or>(U+0000, U+002F, U+003D, or U+003E, respectively).[!NOTE] Earlier versions of the specification were more restrictive, requiring that the
localNamebe a valid XML name.
-
Examples
Basic example
const node = document.getElementById("div1");
const a = document.createAttribute("my_attrib");
a.value = "newVal";
node.setAttributeNode(a);
console.log(node.getAttribute("my_attrib")); // "newVal"
Specifications
SpecificationsStandards references are available on the canonical MDN page.
Browser compatibility
Browser compatibilityCompatibility data is available on the canonical MDN page.