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.

The string given in parameter is converted to lowercase.

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.
Obsolete No change.
Document Object Model (DOM) Level 2 Core Specification
The definition of 'Document.createAttribute()' in that specification.
Obsolete No change.
Document Object Model (DOM) Level 1 Specification
The definition of 'Document.createAttribute()' in that specification.
Obsolete Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
createAttributeChrome Full support 1Edge Full support 12Firefox Full support 44
Full support 44
No support 4 — 44
Notes
Notes The parameter was not converted to its lowercase variant.
IE Full support 6Opera Full support ≤12.1Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 44
Full support 44
No support 4 — 44
Notes
Notes The parameter was not converted to its lowercase variant.
Opera Android Full support ≤12.1Safari iOS Full support 1Samsung Internet Android Full support 1.0

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

See also