Interface Attr

The Attr interface represents an attribute in an Element object. Typically the allowable values for the attribute are defined in a schema associated with the document.

Attr objects inherit the Node interface, but since they are not actually child nodes of the element they describe, the DOM does not consider them part of the document tree. Thus, the Node attributes parentNode, previousSibling and nextSibling have a null value for Attr objects. The DOM takes the view that attributes are properties of elements rather than having a separate identity from the elements they are associated with; this should make it more efficient to implement such features as default attributes associated with all elements of a given type. Furthermore, Attr nodes may not be immediate children of a DocumentFragment. However, they can be associated with Element nodes contained within a DocumentFragment. In short, users and implementors of the DOM need to be aware that Attr nodes have some things in common with other objects inheriting the Node interface, but they also are quite distinct.

Template arguments

interface Attr(DOMString);

Properties

Name	Type	Description
`isId` [get]	`bool`	Returns whether this attribute is known to be of type ID (i.e. to contain an identifier for its owner element) or not. When it is and its value is unique, the ownerElement of this attribute can be retrieved using the method `Document.getElementById`.
`name` [get]	`DOMString`	Returns the name of this attribute. If `Node.localName` is different from `null`, this attribute is a qualified name.
`ownerElement` [get]	`DOMImplementation.Element!DOMString`	The `Element` node this attribute is attached to or `null` if this attribute is not in use.
`schemaTypeInfo` [get]	`XMLTypeInfo!DOMString`	The type information associated with this attribute. While the type information contained in this attribute is guarantee to be correct after loading the document or invoking `Document.normalizeDocument`, `schemaTypeInfo` may not be reliable if the node was moved.
`specified` [get]	`bool`	`true` if this attribute was explicitly given a value in the instance document, `false` otherwise. If the application changed the value of this attribute node (even if it ends up having the same value as the default value) then it is set to `true`. The implementation may handle attributes with default values from other schemas similarly but applications should use `Document.normalizeDocument` to guarantee this information is up-to-date.
`value` [get, set]	`DOMString`	On retrieval, the value of the attribute is returned as a `DOMString`. Character and general entity references are replaced with their values. See also the method `getAttribute` on the `Element` interface. On setting, this creates a `Text` node with the unparsed contents of the string, i.e. any characters that an XML processor would recognize as markup are instead treated as literal text. See also the method `Element.setAttribute`.

Interface Attr

Template arguments

Properties

Authors

Copyright

License