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

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 YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox 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 YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

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

See also