W3cubDocs

/DOM

HTMLElement

The HTMLElement interface represents any HTML element. Some elements directly implement this interface, others implement it via an interface that inherits it.

Properties

Inherits properties from its parent, Element, and implements those from GlobalEventHandlers and TouchEventHandlers.

HTMLElement.accessKey
Is a DOMString representing the access key assigned to the element.
HTMLElement.accessKeyLabel Read only
Returns a DOMString containing the element's assigned access key.
HTMLElement.contentEditable
Is a DOMString, where a value of "true" means the element is editable and a value of "false" means it isn't.
HTMLElement.isContentEditable Read only
Returns a Boolean that indicates whether or not the content of the element can be edited.
HTMLElement.contextMenu
Is a HTMLMenuElement representing the contextual menu associated with the element. It may be null.
HTMLElement.dataset Read only
Returns a DOMStringMap with which script can read and write the element's custom data attributes (data-*) .
HTMLElement.dir
Is a DOMString, reflecting the dir global attribute, representing the directionality of the element. Possible values are "ltr", "rtl", and "auto".
HTMLElement.draggable
Is a Boolean indicating if the element can be dragged.
HTMLElement.dropzone Read only
Returns a DOMSettableTokenList reflecting the dropzone global attribute and describing the behavior of the element regarding a drop operation.
HTMLElement.hidden
Is a Boolean indicating if the element is hidden or not.
HTMLElement.inert
Is a Boolean indicating whether the user agent must act as though the given node is absent for the purposes of user interaction events, in-page text searches ("find in page"), and text selection.
HTMLElement.innerText
Represents the "rendered" text content of a node and its descendants. As a getter, it approximates the text the user would get if they highlighted the contents of the element with the cursor and then copied it to the clipboard.
HTMLElement.itemScope
Is a Boolean representing the item scope.
HTMLElement.itemType Read only
Returns a DOMSettableTokenList
HTMLElement.itemId
Is a DOMString representing the item ID.
HTMLElement.itemRef Read only
Returns a DOMSettableTokenList
HTMLElement.itemProp Read only
Returns a DOMSettableTokenList
HTMLElement.itemValue
Returns a Object representing the item value.
HTMLElement.lang
Is a DOMString representing the language of an element's attributes, text, and element contents.
HTMLElement.noModule
Is a Boolean indicating wether an import script can be executed in user agents that support module scripts.
HTMLElement.nonce
Returns the cryptographic number used once that is used by Content Security Policy to determine whether a given fetch will be allowed to proceed.
HTMLElement.offsetHeight Read only
Returns a double containing the height of an element, relative to the layout.
HTMLElement.offsetLeftRead only
Returns a double, the distance from this element's left border to its offsetParent's left border.
HTMLElement.offsetParentRead only
Returns a Element that is the element from which all offset calculations are currently computed.
HTMLElement.offsetTopRead only
Returns a double, the distance from this element's top border to its offsetParent's top border.
HTMLElement.offsetWidthRead only
Returns a double containing the width of an element, relative to the layout.
HTMLElement.properties Read only
Returns a HTMLPropertiesCollection
HTMLElement.spellcheck
Is a Boolean that controls spell-checking. It is present on all HTML elements, though it doesn't have an effect on all of them.
HTMLElement.style
Is a CSSStyleDeclaration, an object representing the declarations of an element's style attributes.
HTMLElement.tabIndex
Is a long representing the position of the element in the tabbing order.
HTMLElement.title
Is a DOMString containing the text that appears in a popup box when mouse is over the element.
HTMLElement.translate
Is a Boolean representing the translation.

Event handlers

Most event handler properties, of the form onXYZ, are defined on the GlobalEventHandlers or TouchEventHandlers interfaces and implemented by HTMLElement. In addition, the following handlers are specific to HTMLElement.

HTMLElement.oncopy
Returns the event handling code for the copy event (bug 280959).
HTMLElement.oncut
Returns the event handling code for the cut event (bug 280959).
HTMLElement.onpaste
Returns the event handling code for the paste event (bug 280959).
TouchEventHandlers.ontouchstart
Returns the event handling code for the touchstart event.
TouchEventHandlers.ontouchend
Returns the event handling code for the touchend event.
TouchEventHandlers.ontouchmove
Returns the event handling code for the touchmove event.
TouchEventHandlers.ontouchenter
Returns the event handling code for the touchenter event.
TouchEventHandlers.ontouchleave
Returns the event handling code for the touchleave event.
TouchEventHandlers.ontouchcancel
Returns the event handling code for the touchcancel event.

Methods

Inherits methods from its parent, Element.

HTMLElement.blur()
Removes keyboard focus from the currently focused element.
HTMLElement.click()
Sends a mouse click event to the element.
HTMLElement.focus()
Makes the element the current keyboard focus.
HTMLElement.forceSpellCheck()
Runs the spell checker on the element's contents.

Specifications

Specification Status Comment
CSS Object Model (CSSOM) View Module
The definition of 'HTMLElement' in that specification.
Working Draft Added the following properties: offsetParent, offsetTop, offsetLeft, offsetWidth, and offsetHeight.
HTML Living Standard
The definition of 'HTMLElement' in that specification.
Living Standard Added the following properties: translate, itemScope, itemType, itemId, itemRef, itemProp, properties, and itemValue.
Added the following method: forceSpellcheck().
Moved the onXYZ attributes to the GlobalEventHandlers interface and added an inheritance from it.
HTML5
The definition of 'HTMLElement' in that specification.
Recommendation Added the following properties: dataset, hidden, tabindex, accessKey, accessKeyLabel, draggable, dropzone, contentEditable, isContentEditable, contextMenu, spellcheck, commandType, commandLabel, commandIcon, commandHidden, commandDisabled, commandChecked, style, and all the onXYZ properties.
Moved the id and className properties to the Element interface.
Document Object Model (DOM) Level 2 HTML Specification
The definition of 'HTMLElement' in that specification.
Obsolete No change from Document Object Model (DOM) Level 2 HTML Specification
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLElement' in that specification.
Obsolete Initial definition.

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support ? Yes 1 ? ? ?
accessKey 17 Yes 5 ? ? ?
accessKeyLabel ? No 8 ? ? ?
blur ? Yes 5 9 ? ?
click 9
9
Before Chrome 19, click is only defined on buttons and inputs.
Yes 3
3
Before Firefox 5, click is only defined on buttons and inputs, and has no effect on text and file inputs.
Yes Yes Yes
Yes
Before Safari 6, click is only defined on buttons and inputs.
contentEditable Yes Yes 3 5.5 9 Yes
contextMenu ? Yes 1 ? ? ?
dataset 8 Yes 6 11 11 ?
dir ? Yes 1 ? ? ?
draggable Yes Yes 2 Yes 12 Yes
dropzone ? Yes 1 ? ? ?
focus ? Yes 5 9 ? ?
forceSpellCheck No No No No No ?
hidden ? Yes 1 ? ? ?
inert 60 Yes ? ? 47 ?
isContentEditable ? Yes 1 ? ? ?
itemId No No 6 No 11 — 15 ?
itemProp No No 6 No 11 — 15 ?
itemRef No No 6 No 11 — 15 ?
itemScope No No 6 No 11 — 15 ?
itemType No No 6 No 11 — 15 ?
itemValue No No 6 No 11 — 15 ?
lang ? Yes 1 ? ? ?
noModule 60 ? ? No 47 ?
nonce Yes Yes ? ? ? ?
offsetHeight ? Yes 1 Yes ? ?
offsetLeft ? Yes 1 Yes ? ?
offsetParent ? Yes 1 Yes ? ?
offsetTop ? Yes 1 Yes ? ?
offsetWidth ? Yes 1 Yes ? ?
onModule 60 ? ? ? 47 ?
oncopy ? Yes 3 ? ? ?
oncut ? Yes 3 ? ? ?
onpaste ? Yes 3 ? ? ?
outerText Yes Yes No Yes Yes Yes
spellcheck ? Yes 2 ? ? ?
style Yes Yes Yes
Yes
Returns CSS2Properties, rather than CSSStyleDeclaration.
Yes Yes ?
tabIndex ? Yes 1 ? ? ?
title ? Yes 1 ? ? ?
translate No No No No No ?
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes Yes Yes 4 ? ? ?
accessKey ? ? Yes 5 ? ? ?
accessKeyLabel ? ? No 8 ? ? ?
blur ? ? Yes 5 ? ? ?
click Yes
Yes
Before Android WebView 4.4, click is only defined on buttons and inputs.
Yes Yes 5 Yes Yes
Yes
Before Safari 6, click is only defined on buttons and inputs.
?
contentEditable Yes Yes Yes 4 Yes Yes ?
contextMenu Yes Yes Yes 4 ? ? ?
dataset ? ? Yes 6 ? ? ?
dir Yes Yes Yes 4 ? ? ?
draggable Yes Yes Yes 4 Yes Yes ?
dropzone Yes Yes Yes 4 ? ? ?
focus ? ? Yes 5 ? ? ?
forceSpellCheck Yes Yes Yes 4 ? ? ?
hidden Yes Yes Yes 4 ? ? ?
inert 60 60 ? ? 47 ? ?
isContentEditable Yes Yes Yes 4 ? ? ?
itemId Yes Yes Yes 4 ? ? ?
itemProp Yes Yes Yes 4 ? ? ?
itemRef Yes Yes Yes 4 ? ? ?
itemScope Yes Yes Yes 4 ? ? ?
itemType Yes Yes Yes 4 ? ? ?
itemValue Yes Yes Yes 4 ? ? ?
lang Yes Yes Yes 4 ? ? ?
noModule 60 60 ? ? 47 ? ?
nonce Yes Yes ? ? ? ? ?
offsetHeight Yes Yes Yes 4 ? ? ?
offsetLeft Yes Yes Yes 4 ? ? ?
offsetParent Yes Yes Yes 4 ? ? ?
offsetTop Yes Yes Yes 4 ? ? ?
offsetWidth Yes Yes Yes 4 ? ? ?
onModule 60 60 ? ? 47 ? ?
oncopy ? ? Yes 4 ? ? ?
oncut ? ? Yes 4 ? ? ?
onpaste ? ? Yes 4 ? ? ?
outerText Yes Yes Yes No Yes Yes ?
spellcheck Yes Yes Yes 4 ? ? ?
style Yes Yes Yes 4 ? ? ?
tabIndex Yes Yes Yes 4 ? ? ?
title Yes Yes Yes 4 ? ? ?
translate Yes Yes Yes 4 ? ? ?

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement