document.createAttribute

The Document.createAttribute() method creates a new attribute node, and returns it. The object created 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

attribute = document.createAttribute(name) 

Parameters

• name is a string containing the name of the attribute.

Return value

A Attr node.

Exceptions

• INVALID_CHARACTER_ERR if the parameter contains invalid characters for XML attribute.

Example

var node = document.getElementById("div1");
var a = document.createAttribute("my_attrib");
a.value = "newVal";
node.setAttributeNode(a);
console.log(node.getAttribute("my_attrib")); // "newVal"

Specifications

Specification	Status	Comment
DOM The definition of 'Document.createAttribute()' in that specification.	Living Standard	Precised behavior with uppercase characters
Document Object Model (DOM) Level 3 Core Specification The definition of 'Document.createAttribute()' in that specification.	Recommendation	No change.
Document Object Model (DOM) Level 2 Core Specification The definition of 'Document.createAttribute()' in that specification.	Recommendation	No change.
Document Object Model (DOM) Level 1 Specification The definition of 'Document.createAttribute()' in that specification.	Recommendation	Initial definition.

Browser compatibility

[1] Before Firefox 44, the parameter wasn't converted to its lowercase variant.

See also

• Document.createElement()