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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
createAttribute | Chrome Full support 1 | Edge Full support 12 | Firefox
Full support
44
| IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android
Full support
44
| Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- See implementation notes.
- See implementation notes.