{{ APIRef("DOM") }}
The Element
interface represents an object of a {{domxref("Document")}}. This interface describes methods and properties common to all kinds of elements. Specific behaviors are described in interfaces which inherit from Element
but add additional functionality. For example, the {{domxref("HTMLElement")}} interface is the base interface for HTML elements, while the {{domxref("SVGElement")}} interface is the basis for all SVG elements.
Languages outside the realm of the Web platform, like XUL through the XULElement
interface, also implement it.
Properties
Inherits properties from its parents {{domxref("Node")}}, and its own parent, {{domxref("EventTarget")}}, and implements those of {{domxref("ParentNode")}}, {{domxref("ChildNode")}}, {{domxref("NonDocumentTypeChildNode")}}, and {{domxref("Animatable")}}.
- {{ domxref("Element.attributes") }} {{readOnlyInline}}
- Returns a {{ domxref("NamedNodeMap") }} that lists all attributes associated with the element.
- {{ domxref("Element.classList") }} {{readOnlyInline}}
- Returns a {{ domxref("DOMTokenList") }} containing the list of class attributes.
- {{ domxref("Element.className") }}
- Is a {{domxref("DOMString")}} representing the class of the element.
- {{ domxref("Element.clientHeight") }} {{experimental_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the inner height of the element.
- {{ domxref("Element.clientLeft") }} {{experimental_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the width of the left border of the element.
- {{ domxref("Element.clientTop") }} {{experimental_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the width of the top border of the element.
- {{ domxref("Element.clientWidth") }} {{experimental_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the inner width of the element.
- {{ domxref("Element.id") }}
- Is a {{domxref("DOMString")}} representing the id of the element.
- {{ domxref("Element.innerHTML") }}
- Is a {{domxref("DOMString")}} representing the markup of the element's content.
- {{ domxref("Element.localName") }} {{readOnlyInline}}
- A {{domxref("DOMString")}} representing the local part of the qualified name of the element.
- {{domxref("Element.namespaceURI")}} {{readonlyInline}}
- The namespace URI of the element, or
null
if it is no namespace.Note: In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in the
https://www.w3.org/1999/xhtml
namespace in both HTML and XML trees. {{ gecko_minversion_inline("1.9.2") }} - {{ domxref("NonDocumentTypeChildNode.nextElementSibling") }} {{readOnlyInline}}
- Is a {{ domxref("Element") }}, the element immediately following the given one in the tree, or
null
if there's no sibling node. - {{ domxref("Element.outerHTML") }} {{experimental_inline}}
- Is a {{domxref("DOMString")}} representing the markup of the element including its content. When used as a setter, replaces the element with nodes parsed from the given string.
- {{ domxref("Element.prefix") }} {{readOnlyInline}}
- A {{domxref("DOMString")}} representing the namespace prefix of the element, or
null
if no prefix is specified. - {{ domxref("NonDocumentTypeChildNode.previousElementSibling") }} {{readOnlyInline}}
- Is a {{ domxref("Element") }}, the element immediately preceding the given one in the tree, or
null
if there is no sibling element. - {{ domxref("Element.scrollHeight") }} {{experimental_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the scroll view height of an element.
- {{ domxref("Element.scrollLeft") }} {{experimental_inline}}
- Is a {{jsxref("Number")}} representing the left scroll offset of the element.
- {{ domxref("Element.scrollLeftMax") }} {{non-standard_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the maximum left scroll offset possible for the element.
- {{ domxref("Element.scrollTop") }} {{experimental_inline}}
- Is a {{jsxref("Number")}} representing the top scroll offset the an element.
- {{ domxref("Element.scrollTopMax") }} {{non-standard_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the maximum top scroll offset possible for the element.
- {{ domxref("Element.scrollWidth") }} {{experimental_inline}} {{readOnlyInline}}
- Returns a {{jsxref("Number")}} representing the scroll view width of the element.
- {{domxref("Element.shadowRoot") }} {{experimental_inline}} {{readOnlyInline}}
- Returns the youngest shadow root that is hosted by the element.
- {{domxref("Element.tabStop")}} {{non-standard_inline}}
- Is a {{jsxref("Boolean")}} indicating if the element can receive input focus via the tab key.
- {{ domxref("Element.tagName") }} {{readOnlyInline}}
- Returns a {{domxref("String")}} with the name of the tag for the given element.
- {{ domxref("Element.undoManager")}} {{experimental_inline}} {{readOnlyInline}}
- Returns the {{domxref("UndoManager")}} associated with the element.
- {{ domxref("Element.undoScope")}} {{experimental_inline}}
- Is a {{jsxref("Boolean")}} indicating if the element is an undo scope host, or not.
Note: DOM Level 3 defined namespaceURI
, localName
and prefix
on the {{domxref("Node")}} interface. In DOM4 they were moved to Element
.
This change is implemented in Chrome since version 46.0 and Firefox since version 48.0.
Event handlers
- {{ domxref("Element.ongotpointercapture") }}
- Returns the event handler for the {{event("gotpointercapture")}} event type.
- {{ domxref("Element.onlostpointercapture") }}
- Returns the event handler for the {{event("lostpointercapture")}} event type.
- {{ domxref("Element.onwheel") }} {{ non-standard_inline() }}
- Returns the event handling code for the {{ domeventxref("wheel") }} event.
Methods
Inherits methods from its parents {{domxref("Node")}}, and its own parent, {{domxref("EventTarget")}}, and implements those of {{domxref("ParentNode")}}, {{domxref("ChildNode")}}, {{domxref("NonDocumentTypeChildNode")}}, and {{domxref("Animatable")}}.
- {{ domxref("EventTarget.addEventListener()") }}
- Registers an event handler to a specific event type on the element.
- {{domxref("Element.attachShadow()")}} {{experimental_inline}}
- Attatches a shadow DOM tree to the specified element and returns a reference to its {{domxref("ShadowRoot")}}.
- {{domxref("Element.animate()")}} {{experimental_inline}}
- A shortcut method to create and run an animation on an element. Returns the created Animation object instance.
- {{ domxref("Element.closest()")}} {{experimental_inline}}
- Returns the {{domxref("Element")}}, descendant of this element (or this element itself), that is the closest ancestor of the elements selected by the selectors given in parameter.
- {{ domxref("Element.createShadowRoot()")}} {{experimental_inline}} {{deprecated_inline()}}
- Creates a shadow DOM on on the element, turning it into a shadow host. Returns a {{domxref("ShadowRoot")}}.
- {{ domxref("EventTarget.dispatchEvent()") }}
- Dispatches an event to this node in the DOM and returns a {{jsxref("Boolean")}} that indicates that at least one handler has not canceled it.
- {{domxref("Element.find()")}}{{experimental_inline}}
- ...
- {{domxref("Element.findAll()")}}{{experimental_inline}}
- ...
- {{domxref("Element.getAnimations()")}} {{experimental_inline}}
- Returns an array of Animation objects currently active on the element.
- {{ domxref("Element.getAttribute()") }}
- Retrieves the value of the named attribute from the current node and returns it as an {{jsxref("Object")}}.
- {{ domxref("Element.getAttributeNames()") }}
- {{ domxref("Element.getAttributeNS()") }}
- Retrieves the value of the attribute with the specified name and namespace, from the current node and returns it as an {{jsxref("Object")}}.
- {{ domxref("Element.getAttributeNode()") }} {{obsolete_inline}}
- Retrieves the node representation of the named attribute from the current node and returns it as an {{ domxref("Attr") }}.
- {{ domxref("Element.getAttributeNodeNS()") }} {{obsolete_inline}}
- Retrieves the node representation of the attribute with the specified name and namespace, from the current node and returns it as an {{ domxref("Attr") }}.
- {{ domxref("Element.getBoundingClientRect()") }}
- ...
- {{ domxref("Element.getClientRects()") }}
- Returns a collection of rectangles that indicate the bounding rectangles for each line of text in a client.
- {{domxref("Element.getDestinationInsertionPoints()")}} {{experimental_inline}}
- …
- {{ domxref("Element.getElementsByClassName()") }}
- Returns a live {{ domxref("HTMLCollection") }} that contains all descendant of the current element that posses the list of classes given in parameter.
- {{ domxref("Element.getElementsByTagName()") }}
- Returns a live {{ domxref("HTMLCollection") }} containing all descendant elements, of a particular tag name, from the current element.
- {{ domxref("Element.getElementsByTagNameNS()") }}
- Returns a live {{ domxref("HTMLCollection") }} containing all descendant elements, of a particular tag name and namespace, from the current element.
- {{ domxref("Element.hasAttribute()") }}
- Returns a {{jsxref("Boolean")}} indicating if the element has the specified attribute or not.
- {{ domxref("Element.hasAttributeNS()") }}
- Returns a {{jsxref("Boolean")}} indicating if the element has the specified attribute, in the specified namespace, or not.
- {{ domxref("Element.hasAttributes()") }}
- Returns a {{jsxref("Boolean")}} indicating if the element has one or more HTML attributes present.
- {{ domxref("Element.insertAdjacentElement") }} {{experimental_inline}}
- Inserts a given element node at a given position relative to the element it is invoked upon.
- {{ domxref("Element.insertAdjacentHTML") }} {{experimental_inline}}
- Parses the text as HTML or XML and inserts the resulting nodes into the tree in the position given.
- {{ domxref("Element.insertAdjacentText") }} {{experimental_inline}}
- Inserts a given text node at a given position relative to the element it is invoked upon.
- {{ domxref("Element.matches()") }}
- Returns a {{jsxref("Boolean")}} indicating whether or not the element would be selected by the specified selector string.
- {{ domxref("Element.querySelector()") }}
- Returns the first {{ domxref("Node") }} which matches the specified selector string relative to the element.
- {{ domxref("Element.querySelectorAll") }}
- Returns a {{ domxref("NodeList") }} of nodes which match the specified selector string relative to the element.
- {{ domxref("Element.releasePointerCapture")}}
- Releases (stops) pointer capture that was previously set for a specific {{domxref("PointerEvent","pointer event")}}.
- {{domxref("ChildNode.remove()")}} {{experimental_inline}}
- Removes the element from the children list of its parent.
- {{ domxref("Element.removeAttribute()") }}
- Removes the named attribute from the current node.
- {{ domxref("Element.removeAttributeNS()") }}
- Removes the attribute with the specified name and namespace, from the current node.
- {{ domxref("Element.removeAttributeNode()") }} {{obsolete_inline}}
- Removes the node representation of the named attribute from the current node.
- {{ domxref("EventTarget.removeEventListener()") }}
- Removes an event listener from the element.
- {{ domxref("Element.requestFullscreen()") }} {{experimental_inline}}
- Asynchronously asks the browser to make the element full-screen.
- {{ domxref("Element.requestPointerLock()")}} {{experimental_inline}}
- Allows to asynchronously ask for the pointer to be locked on the given element.
- {{ domxref("Element.scrollIntoView()") }} {{experimental_inline}}
- Scrolls the page until the element gets into the view.
- {{ domxref("Element.setAttribute()") }}
- Sets the value of a named attribute of the current node.
- {{ domxref("Element.setAttributeNS()") }}
- Sets the value of the attribute with the specified name and namespace, from the current node.
- {{ domxref("Element.setAttributeNode()") }} {{obsolete_inline}}
- Sets the node representation of the named attribute from the current node.
- {{ domxref("Element.setAttributeNodeNS()") }} {{obsolete_inline}}
- Setw the node representation of the attribute with the specified name and namespace, from the current node.
- {{ domxref("Element.setCapture()") }} {{non-standard_inline}}
- Sets up mouse event capture, redirecting all mouse events to this element.
- {{domxref("Element.setPointerCapture()")}}
- Designates a specific element as the capture target of future {{domxref("PointerEvent","pointer events")}}.
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('Shadow DOM')}} | {{Spec2('Shadow DOM')}} | |
{{SpecName("Web Animations", '', '')}} | {{Spec2("Web Animations")}} | Added the getAnimations() method. |
{{SpecName('Undo Manager', '', 'Element')}} | {{Spec2('Undo Manager')}} | Added the undoScope and undoManager properties. |
{{SpecName('Pointer Events 2', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('Pointer Events 2')}} | Added the following event handlers: ongotpointercapture and onlostpointercapture .Added the following methods: setPointerCapture() and releasePointerCapture() . |
{{SpecName('Pointer Events', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('Pointer Events')}} | Added the following event handlers: ongotpointercapture and onlostpointercapture .Added the following methods: setPointerCapture() and releasePointerCapture() . |
{{SpecName('Selectors API Level 2', '#interface-definitions', 'Element')}} | {{Spec2('Selectors API Level 2')}} | Added the following methods: matches() (implemented as mozMatchesSelector() ), find() , findAll() . |
{{SpecName('Selectors API Level 1', '#interface-definitions', 'Element')}} | {{Spec2('Selectors API Level 1')}} | Added the following methods: querySelector() and querySelectorAll() . |
{{SpecName('Pointer Lock', 'index.html#element-interface', 'Element')}} | {{Spec2('Pointer Lock')}} | Added the requestPointerLock() method. |
{{SpecName('Fullscreen', '#api', 'Element')}} | {{Spec2('Fullscreen')}} | Added the requestFullscreen() method. |
{{SpecName('DOM Parsing', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('DOM Parsing')}} | Added the following properties: innerHTML , and outerHTML .Added the following method: insertAdjacentHTML() . |
{{SpecName('CSSOM View', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('CSSOM View')}} | Added the following properties: scrollTop , scrollLeft , scrollWidth , scrollHeight , clientTop , clientLeft , clientWidth , and clientHeight .Added the following methods: getClientRects() , getBoundingClientRect() , and scrollIntoView() . |
{{SpecName('Element Traversal', '#ecmascript-bindings', 'Element')}} | {{Spec2('Element Traversal')}} | Added inheritance of the {{domxref("ElementTraversal")}} interface. |
{{SpecName('DOM WHATWG', '#interface-element', 'Element')}} | {{Spec2('DOM WHATWG')}} | Removed the following methods: closest() , setIdAttribute() , setIdAttributeNS() , and setIdAttributeNode() .Removed the schemaTypeInfo property.Modified the return value of getElementsByTag() and getElementsByTagNS() .Moved hasAttributes() form the Node interface to this one.Inserted insertAdjacentElement() and insertAdjacentText() . |
{{SpecName('DOM3 Core', 'core.html#ID-745549614', 'Element')}} | {{Spec2('DOM3 Core')}} | Added the following methods: setIdAttribute() , setIdAttributeNS() , and setIdAttributeNode() . These methods were never implemented and have been removed in later specifications.Added the schemaTypeInfo property. This property was never implemented and has been removed in later specifications. |
{{SpecName('DOM2 Core', 'core.html#ID-745549614', 'Element')}} | {{Spec2('DOM2 Core')}} | The normalize() method has been moved to {{domxref("Node")}}. |
{{SpecName('DOM1', 'level-one-core.html#ID-745549614', 'Element')}} | {{Spec2('DOM1')}} | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 1.0 | {{CompatGeckoDesktop("1")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | 1.0 |
children |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9")}} | 7.0 with a significant bug [1] 9.0 according to the spec |
{{CompatVersionUnknown}} | {{CompatNo}} |
childElementCount , nextElementSibling , previousElementSibling |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9.1")}} | 9.0 | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
firstElementChild , lastElementChild |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9")}} | 9.0 | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
classList |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9.2")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | |
outerHTML {{experimental_inline}} |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("11")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
clientLeft , clientTop {{experimental_inline}} |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9.1")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
getBoundingClientRect() , getClientRects() {{experimental_inline}} |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
querySelector() , querySelectorAll() |
1.0 | {{CompatGeckoDesktop("1.9.1")}} | 8.0 | 10.0 | 3.2 (525.3) |
insertAdjacentHTML() {{experimental_inline}} |
1.0 | {{CompatGeckoDesktop("8")}} | 4.0 | 7.0 | 4.0 (527) |
setCapture() {{non-standard_inline}} |
{{CompatNo}} | {{CompatGeckoDesktop("2")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
oncopy , oncut , onpaste {{non-standard_inline}} |
{{CompatNo}} | {{CompatGeckoDesktop("1.9")}} | {{CompatVersionUnknown}} | {{CompatNo}} | |
onwheel {{non-standard_inline}} |
{{CompatNo}} | {{CompatGeckoDesktop("17")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
ongotpointercapture , onlostpointercapture , setPointerCapture() , and releasePointerCapture() |
{{CompatNo}} | {{CompatVersionUnknown}} [3] | 10.0 | {{CompatNo}} | {{CompatNo}} |
matches() {{experimental_inline}} |
{{CompatVersionUnknown}} with the non-standard name webkitMatchesSelector |
{{CompatGeckoDesktop("1.9.2")}} with the non-standard name mozMatchesSelector {{CompatGeckoDesktop("34")}} with the standard name |
9.0 with the non-standard name msMatchesSelector |
11.5 with the non-standard name oMatchesSelector 15.0 with the non-standard name webkitMatchesSelector |
5.0 with the non-standard name webkitMatchesSelector |
find() and findAll() |
{{CompatNo}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
requestPointerLock() |
16.0 {{property_prefix("webkit")}}, behind an about:flags 22.0 {{property_prefix("webkit")}} (with special cases, progressively lifted see [2]) |
{{CompatGeckoDesktop("14")}}{{property_prefix("moz")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
requestFullscreen() |
14.0 {{property_prefix("webkit")}} | {{CompatGeckoDesktop("10")}} {{property_prefix("moz")}} | 11.0 {{property_prefix("ms")}} | 12.10 15.0 {{property_prefix("webkit")}} |
5.1 {{property_prefix("webkit")}} |
undoManager and undoScope |
{{CompatNo}} | {{CompatVersionUnknown}} (behind the dom.undo_manager.enabled pref) |
{{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
attributes |
{{CompatUnknown}} | {{CompatGeckoDesktop("22")}} Before this it was available via the {{domxref("Node")}} interface that any element inherits. |
{{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
scrollTopMax() and scrollLeftMax() |
{{CompatNo}} | {{CompatGeckoDesktop("16")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
closest() |
{{CompatUnknown}} | {{CompatGeckoDesktop("35")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
hasAttributes() |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.0")}} (on the {{domxref("Node")}} interface) {{CompatGeckoDesktop("35")}} (on this interface |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
insertAdjacentElement() , insertAdjacentText() |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("48.0")}} | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | 1.0 | {{CompatGeckoMobile("1")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | 1.0 |
scrollTopMax() and scrollLeftMax() |
{{CompatNo}} | {{CompatGeckoMobile("16")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
closest() |
{{CompatUnknown}} | {{CompatGeckoMobile("35")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
hasAttributes() |
{{CompatVersionUnknown}} | {{CompatGeckoMobile("1.0")}} (on the {{domxref("Node")}} interface) {{CompatGeckoMobile("35")}} (on this interface |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
insertAdjacentElement() , insertAdjacentText() |
{{CompatVersionUnknown}} | {{CompatGeckoMobile("48.0")}} | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
[1] Internet Explorer 7 and 8 incorrectly return the comments as part of the children of an Element. This is fixed in Internet Explorer 9 and later.
[2] Chrome 16 allowed webkitRequestPointerLock()
only in fullscreen; Chrome 21 for trusted web site (permission asked); Chrome 22 allowed it by default for all same-origin document; Chrome 23 allowed it in sandboxed {{HTMLElement("iframe")}} if the non-standard value webkit-allow-pointer-lock
is set to the {{htmlattrxref("sandbox", "iframe")}} attribute.
[3] Implementation withdrawn. See {{Bug("1166347")}}.